diff --git a/AGENTS.md b/AGENTS.md index 51c51ff..4a0d694 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,10 +3,10 @@ Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md. ## Collaboration Artifacts -- Directory: `collab/` -- Naming: `-.md` - - Examples: `00-bootstrap-questions.md`, `01-wrapper-proposal.md`, `01-wrapper-plan.md` -- Types: `questions`, `proposal`, `plan` +- Root: `collab/` +- Subdirectories: `collab/questions/`, `collab/proposals/`, `collab/plan/` +- Naming: `.md` inside each subdirectory + - 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. ## 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`. - Propose in `collab/<...>-proposal.md`, plan in `collab/<...>-plan.md`, then implement. - Respect repository structure and this AGENTS.md across all changes. - diff --git a/SeedPrompt.md b/SeedPrompt.md index a5d9cf3..d31d3bc 100644 --- a/SeedPrompt.md +++ b/SeedPrompt.md @@ -40,8 +40,9 @@ Commit/push everything in the repo now before we get started on the project. ## Addendum (Housekeeping) — 2025-09-17 - Create and use a `collab/` directory for coordination artifacts. -- Use consistent filenames: `-.md` where `` is one of `questions`, `proposal`, `plan`. -- Move any existing questions into `collab/` following the naming scheme (e.g., `00-bootstrap-questions.md`). +- Under `collab/`, create subdirectories: `questions/`, `proposals/`, and `plan/`. +- Use consistent filenames: `.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. - Continue keeping `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated. - After applying this structure, commit and push the changes. diff --git a/collab/00-bootstrap-plan.md b/collab/plan/00-bootstrap.md similarity index 65% rename from collab/00-bootstrap-plan.md rename to collab/plan/00-bootstrap.md index bf2103b..cf73cb9 100644 --- a/collab/00-bootstrap-plan.md +++ b/collab/plan/00-bootstrap.md @@ -1,11 +1,10 @@ # 00 — Bootstrap — Plan 1. Create `collab/` directory for coordination artifacts. -2. Move `QUESTIONS.md` to `collab/00-bootstrap-questions.md`. -3. Add `collab/00-bootstrap-proposal.md` and this plan file. +2. Move `QUESTIONS.md` to `collab/questions/00-bootstrap.md`. +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. 5. Append Addendum to `SeedPrompt.md` describing the new structure. 6. Commit and push changes to `main`. Status: pending review/confirmation. - diff --git a/collab/00-bootstrap-proposal.md b/collab/proposals/00-bootstrap.md similarity index 80% rename from collab/00-bootstrap-proposal.md rename to collab/proposals/00-bootstrap.md index 3d6605b..56f3682 100644 --- a/collab/00-bootstrap-proposal.md +++ b/collab/proposals/00-bootstrap.md @@ -8,13 +8,12 @@ Scope: - Maintain `AGENTS.md` with working conventions and agent guidance. Deliverables (this step): -- collab/00-bootstrap-questions.md (moved from root) -- collab/00-bootstrap-proposal.md (this file) -- collab/00-bootstrap-plan.md (skeleton) +- collab/questions/00-bootstrap.md (moved from root QUESTIONS.md) +- collab/proposals/00-bootstrap.md (this file) +- collab/plan/00-bootstrap.md (skeleton) - AGENTS.md (initial content) - SeedPrompt.md updated with an Addendum describing this structure Acceptance Criteria: - Repo contains the above files with agreed naming scheme. - CI not required; manual review suffices for this step. - diff --git a/collab/00-bootstrap-questions.md b/collab/questions/00-bootstrap.md similarity index 100% rename from collab/00-bootstrap-questions.md rename to collab/questions/00-bootstrap.md diff --git a/devlog/DEVLOG_HUMAN.md b/devlog/DEVLOG_HUMAN.md index b26ee66..61f8685 100644 --- a/devlog/DEVLOG_HUMAN.md +++ b/devlog/DEVLOG_HUMAN.md @@ -22,8 +22,8 @@ Notes: Date: 2025-09-17 09:05 (UTC) Summary: -- Introduced `collab/` directory and moved QUESTIONS into `collab/00-bootstrap-questions.md`. -- Added `collab/00-bootstrap-proposal.md` and `collab/00-bootstrap-plan.md`. +- Introduced `collab/` directory and moved QUESTIONS into `collab/questions/00-bootstrap.md`. +- Added `collab/proposals/00-bootstrap.md` and `collab/plan/00-bootstrap.md`. - Created `AGENTS.md` with working conventions. - Appended housekeeping Addendum to `SeedPrompt.md`. diff --git a/devlog/DEVLOG_LLM.md b/devlog/DEVLOG_LLM.md index 09352af..647b497 100644 --- a/devlog/DEVLOG_LLM.md +++ b/devlog/DEVLOG_LLM.md @@ -16,12 +16,12 @@ This log is concise and structured for quick machine parsing and summarization. ## 2025-09-17T09:05Z - context: Housekeeping structure introduced - actions: - - Created `collab/` directory and moved questions to `collab/00-bootstrap-questions.md` - - Added `collab/00-bootstrap-proposal.md` and `collab/00-bootstrap-plan.md` + - Created `collab/` directory and moved questions to `collab/questions/00-bootstrap.md` + - Added `collab/proposals/00-bootstrap.md` and `collab/plan/00-bootstrap.md` - Added `AGENTS.md` - Appended housekeeping Addendum to `SeedPrompt.md` - decisions: - Adopt filename pattern `-.md` for collab artifacts - 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