chore: restructure collab into questions/proposals/plan subdirs; update references
This commit is contained in:
@@ -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.
|
||||||
|
|
||||||
|
@@ -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.
|
||||||
|
@@ -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.
|
||||||
|
|
@@ -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.
|
||||||
|
|
@@ -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`.
|
||||||
|
|
||||||
|
@@ -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
|
||||||
|
Reference in New Issue
Block a user