chore: restructure collab into questions/proposals/plan subdirs; update references

This commit is contained in:
2025-09-17 09:01:52 -05:00
parent 6dddc7d6b4
commit 064f3a9d1a
7 changed files with 17 additions and 19 deletions

View File

@@ -3,10 +3,10 @@
Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md. Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md.
## Collaboration Artifacts ## Collaboration Artifacts
- Directory: `collab/` - Root: `collab/`
- Naming: `<step-or-subject>-<type>.md` - Subdirectories: `collab/questions/`, `collab/proposals/`, `collab/plan/`
- Examples: `00-bootstrap-questions.md`, `01-wrapper-proposal.md`, `01-wrapper-plan.md` - Naming: `<step-or-subject>.md` inside each subdirectory
- Types: `questions`, `proposal`, `plan` - Examples: `collab/questions/00-bootstrap.md`, `collab/proposals/01-wrapper.md`, `collab/plan/01-wrapper.md`
- Principle: Keep chat minimal; prefer file-based collaboration via these documents. - Principle: Keep chat minimal; prefer file-based collaboration via these documents.
## Logs and Documentation ## Logs and Documentation
@@ -32,4 +32,3 @@ Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md.
- Ask clarifying questions in `collab/<...>-questions.md`. - Ask clarifying questions in `collab/<...>-questions.md`.
- Propose in `collab/<...>-proposal.md`, plan in `collab/<...>-plan.md`, then implement. - Propose in `collab/<...>-proposal.md`, plan in `collab/<...>-plan.md`, then implement.
- Respect repository structure and this AGENTS.md across all changes. - Respect repository structure and this AGENTS.md across all changes.

View File

@@ -40,8 +40,9 @@ Commit/push everything in the repo now before we get started on the project.
## Addendum (Housekeeping) — 2025-09-17 ## Addendum (Housekeeping) — 2025-09-17
- Create and use a `collab/` directory for coordination artifacts. - Create and use a `collab/` directory for coordination artifacts.
- Use consistent filenames: `<step-or-subject>-<type>.md` where `<type>` is one of `questions`, `proposal`, `plan`. - Under `collab/`, create subdirectories: `questions/`, `proposals/`, and `plan/`.
- Move any existing questions into `collab/` following the naming scheme (e.g., `00-bootstrap-questions.md`). - Use consistent filenames: `<step-or-subject>.md` inside each subdirectory.
- Move existing files accordingly (e.g., `collab/questions/00-bootstrap.md`).
- Create and maintain an `AGENTS.md` at the repo root with working agreements and conventions. - Create and maintain an `AGENTS.md` at the repo root with working agreements and conventions.
- Continue keeping `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated. - Continue keeping `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated.
- After applying this structure, commit and push the changes. - After applying this structure, commit and push the changes.

View File

@@ -1,11 +1,10 @@
# 00 — Bootstrap — Plan # 00 — Bootstrap — Plan
1. Create `collab/` directory for coordination artifacts. 1. Create `collab/` directory for coordination artifacts.
2. Move `QUESTIONS.md` to `collab/00-bootstrap-questions.md`. 2. Move `QUESTIONS.md` to `collab/questions/00-bootstrap.md`.
3. Add `collab/00-bootstrap-proposal.md` and this plan file. 3. Add `collab/proposals/00-bootstrap.md` and this plan file at `collab/plan/00-bootstrap.md`.
4. Create `AGENTS.md` capturing repository working agreements. 4. Create `AGENTS.md` capturing repository working agreements.
5. Append Addendum to `SeedPrompt.md` describing the new structure. 5. Append Addendum to `SeedPrompt.md` describing the new structure.
6. Commit and push changes to `main`. 6. Commit and push changes to `main`.
Status: pending review/confirmation. Status: pending review/confirmation.

View File

@@ -8,13 +8,12 @@ Scope:
- Maintain `AGENTS.md` with working conventions and agent guidance. - Maintain `AGENTS.md` with working conventions and agent guidance.
Deliverables (this step): Deliverables (this step):
- collab/00-bootstrap-questions.md (moved from root) - collab/questions/00-bootstrap.md (moved from root QUESTIONS.md)
- collab/00-bootstrap-proposal.md (this file) - collab/proposals/00-bootstrap.md (this file)
- collab/00-bootstrap-plan.md (skeleton) - collab/plan/00-bootstrap.md (skeleton)
- AGENTS.md (initial content) - AGENTS.md (initial content)
- SeedPrompt.md updated with an Addendum describing this structure - SeedPrompt.md updated with an Addendum describing this structure
Acceptance Criteria: Acceptance Criteria:
- Repo contains the above files with agreed naming scheme. - Repo contains the above files with agreed naming scheme.
- CI not required; manual review suffices for this step. - CI not required; manual review suffices for this step.

View File

@@ -22,8 +22,8 @@ Notes:
Date: 2025-09-17 09:05 (UTC) Date: 2025-09-17 09:05 (UTC)
Summary: Summary:
- Introduced `collab/` directory and moved QUESTIONS into `collab/00-bootstrap-questions.md`. - Introduced `collab/` directory and moved QUESTIONS into `collab/questions/00-bootstrap.md`.
- Added `collab/00-bootstrap-proposal.md` and `collab/00-bootstrap-plan.md`. - Added `collab/proposals/00-bootstrap.md` and `collab/plan/00-bootstrap.md`.
- Created `AGENTS.md` with working conventions. - Created `AGENTS.md` with working conventions.
- Appended housekeeping Addendum to `SeedPrompt.md`. - Appended housekeeping Addendum to `SeedPrompt.md`.

View File

@@ -16,12 +16,12 @@ This log is concise and structured for quick machine parsing and summarization.
## 2025-09-17T09:05Z ## 2025-09-17T09:05Z
- context: Housekeeping structure introduced - context: Housekeeping structure introduced
- actions: - actions:
- Created `collab/` directory and moved questions to `collab/00-bootstrap-questions.md` - Created `collab/` directory and moved questions to `collab/questions/00-bootstrap.md`
- Added `collab/00-bootstrap-proposal.md` and `collab/00-bootstrap-plan.md` - Added `collab/proposals/00-bootstrap.md` and `collab/plan/00-bootstrap.md`
- Added `AGENTS.md` - Added `AGENTS.md`
- Appended housekeeping Addendum to `SeedPrompt.md` - Appended housekeeping Addendum to `SeedPrompt.md`
- decisions: - decisions:
- Adopt filename pattern `<step-or-subject>-<type>.md` for collab artifacts - Adopt filename pattern `<step-or-subject>-<type>.md` for collab artifacts
- next: - next:
- Await answers in `collab/00-bootstrap-questions.md` - Await answers in `collab/questions/00-bootstrap.md`
- Then fill proposal/plan and proceed to implementation - Then fill proposal/plan and proceed to implementation