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.
## Collaboration Artifacts
- Directory: `collab/`
- Naming: `<step-or-subject>-<type>.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: `<step-or-subject>.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.

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
- 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`.
- 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: `<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.
- Continue keeping `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated.
- After applying this structure, commit and push the changes.

View File

@@ -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.

View File

@@ -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.

View File

@@ -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`.

View File

@@ -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 `<step-or-subject>-<type>.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