docs(devlog): move DevLog under docs/; update references in AGENTS.md and SeedPrompt.md
This commit is contained in:
@@ -16,7 +16,7 @@ Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md.
|
|||||||
- After approval, create a concise proposal in `collab/proposals/` and a concrete plan in `collab/plan/`, then implement.
|
- After approval, create a concise proposal in `collab/proposals/` and a concrete plan in `collab/plan/`, then implement.
|
||||||
|
|
||||||
## Logs and Documentation
|
## Logs and Documentation
|
||||||
- Dev logs: `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated each meaningful change.
|
- Dev logs: `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md` updated each meaningful change.
|
||||||
- Project docs: `docs/` for feature docs (`<feature>.md`) and architectural decisions (`adr-<feature>.md`).
|
- Project docs: `docs/` for feature docs (`<feature>.md`) and architectural decisions (`adr-<feature>.md`).
|
||||||
- README: Keep `README.md` current with quickstart and usage.
|
- README: Keep `README.md` current with quickstart and usage.
|
||||||
|
|
||||||
|
@@ -44,7 +44,7 @@ Commit/push everything in the repo now before we get started on the project.
|
|||||||
- Use consistent filenames: `<step-or-subject>.md` inside each subdirectory.
|
- Use consistent filenames: `<step-or-subject>.md` inside each subdirectory.
|
||||||
- Move existing files accordingly (e.g., `collab/questions/00-bootstrap.md`).
|
- 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 `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md` updated.
|
||||||
- After applying this structure, commit and push the changes.
|
- After applying this structure, commit and push the changes.
|
||||||
|
|
||||||
### Chat Output Preference
|
### Chat Output Preference
|
||||||
@@ -64,7 +64,7 @@ Commit/push everything in the repo now before we get started on the project.
|
|||||||
|
|
||||||
### Token Discipline
|
### Token Discipline
|
||||||
|
|
||||||
- Keep chat output extremely concise; use the filesystem for details.
|
- Keep chat output extremely concise; use the filesystem (docs/devlog, collab/) for details.
|
||||||
- Summarize for the model in `.llm.md` companions; keep human-readable detail in the primary `.md`.
|
- Summarize for the model in `.llm.md` companions; keep human-readable detail in the primary `.md`.
|
||||||
- Do not paste large content into chat; write to files and reference paths.
|
- Do not paste large content into chat; write to files and reference paths.
|
||||||
- Prefer starting new numbered files per round to keep each doc short.
|
- Prefer starting new numbered files per round to keep each doc short.
|
||||||
|
@@ -1,43 +0,0 @@
|
|||||||
# Dev Log (LLM-Optimized)
|
|
||||||
|
|
||||||
This log is concise and structured for quick machine parsing and summarization. One entry per session/change.
|
|
||||||
|
|
||||||
## 2025-09-17T08:55Z
|
|
||||||
- context: Initialized collaboration per SeedPrompt.md
|
|
||||||
- actions:
|
|
||||||
- Added `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md`
|
|
||||||
- Added `QUESTIONS.md` to drive collaboration
|
|
||||||
- decisions:
|
|
||||||
- Defer tagging a release until first runnable wrapper exists
|
|
||||||
- next:
|
|
||||||
- Await answers in `QUESTIONS.md`
|
|
||||||
- Draft proposal and implementation plan once clarified
|
|
||||||
|
|
||||||
## 2025-09-17T09:05Z
|
|
||||||
- context: Housekeeping structure introduced
|
|
||||||
- actions:
|
|
||||||
- Created `collab/` directory and moved questions to `collab/questions/00-bootstrap.md`
|
|
||||||
- Added collaboration structure docs in `AGENTS.md` and SeedPrompt addendum
|
|
||||||
- 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/questions/00-bootstrap.md`; only after approval, create proposal and plan
|
|
||||||
|
|
||||||
## 2025-09-17T09:15Z
|
|
||||||
- context: Process sequencing refined per user request
|
|
||||||
- actions:
|
|
||||||
- Removed `collab/proposals/00-bootstrap.md` and `collab/plan/00-bootstrap.md`
|
|
||||||
- Updated AGENTS.md and SeedPrompt addendum with sequencing rules
|
|
||||||
- decisions:
|
|
||||||
- Proposals/plans only after questions approved
|
|
||||||
- next:
|
|
||||||
- Wait for questions file edits/approval
|
|
||||||
|
|
||||||
## 2025-09-17T14:52Z
|
|
||||||
- context: Clarified intent for explainers vs user answers
|
|
||||||
- actions:
|
|
||||||
- Replaced prior “Answers/Explainers” with targeted “Explainers” answering back-questions (subcommands tradeoffs, scaffolding examples, overlay purpose)
|
|
||||||
- next:
|
|
||||||
- Await further inline edits or approval to proceed to proposal/plan
|
|
@@ -11,7 +11,7 @@ Details:
|
|||||||
- Scope: No functional code yet; this is setup to enable fast iteration.
|
- Scope: No functional code yet; this is setup to enable fast iteration.
|
||||||
|
|
||||||
Next Steps:
|
Next Steps:
|
||||||
- Collect answers in QUESTIONS.md.
|
- Collect answers in `collab/questions/00-bootstrap.md`.
|
||||||
- With clarifications, propose initial design and plan for the wrapper script (crawl phase).
|
- With clarifications, propose initial design and plan for the wrapper script (crawl phase).
|
||||||
|
|
||||||
Notes:
|
Notes:
|
||||||
@@ -22,34 +22,34 @@ 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/questions/00-bootstrap.md`.
|
- Introduced `collab/` directory; moved QUESTIONS into `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`.
|
||||||
- Created `AGENTS.md` with working conventions.
|
|
||||||
- Appended housekeeping Addendum to `SeedPrompt.md`.
|
|
||||||
|
|
||||||
Details:
|
Details:
|
||||||
- Establishes consistent file-based collaboration area and naming scheme.
|
- Establishes consistent file-based collaboration area and naming scheme.
|
||||||
|
|
||||||
Next Steps:
|
Next Steps:
|
||||||
- Await answers to bootstrap questions. Only after you approve the questions file will we draft a proposal and plan.
|
- Await answers to bootstrap questions, then proceed after approval.
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Date: 2025-09-17 09:15 (UTC)
|
|
||||||
|
|
||||||
Summary:
|
|
||||||
- Removed initial proposal and plan files per process update.
|
|
||||||
- Updated AGENTS.md and SeedPrompt addendum to encode sequencing rules (questions → approval → proposal/plan → implement).
|
|
||||||
|
|
||||||
Next Steps:
|
|
||||||
- Wait for your edits/approval in `collab/questions/00-bootstrap.md`.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Date: 2025-09-17 14:52 (UTC)
|
Date: 2025-09-17 14:52 (UTC)
|
||||||
|
|
||||||
Summary:
|
Summary:
|
||||||
- Adjusted questions doc to replace prior “Answers/Explainers” with an “Explainers” section focused on responding to your back-questions (subcommand tradeoffs, scaffolding examples, overlay purpose, project.md template behavior).
|
- Adjusted questions doc to replace prior “Answers/Explainers” with an “Explainers” section focused on responding to back-questions.
|
||||||
|
|
||||||
Next Steps:
|
Next Steps:
|
||||||
- Await your confirmation or additional edits; then, on approval, I’ll draft the proposal and plan.
|
- Await your confirmation or additional edits; then, on approval, draft proposal and plan.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Date: 2025-09-17 15:00 (UTC)
|
||||||
|
|
||||||
|
Summary:
|
||||||
|
- Adopted token/context hygiene policy; moved DevLog under docs/.
|
||||||
|
|
||||||
|
Details:
|
||||||
|
- Updated AGENTS.md and SeedPrompt addendum to emphasize filesystem-first collaboration and minimal chat.
|
||||||
|
|
||||||
|
Next Steps:
|
||||||
|
- Continue logging details here, keep chat concise.
|
48
docs/devlog/DEVLOG_LLM.md
Normal file
48
docs/devlog/DEVLOG_LLM.md
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
# Dev Log (LLM-Optimized)
|
||||||
|
|
||||||
|
This log is concise and structured for quick machine parsing and summarization. One entry per session/change.
|
||||||
|
|
||||||
|
## 2025-09-17T08:55Z
|
||||||
|
- context: Initialized collaboration per SeedPrompt.md
|
||||||
|
- actions:
|
||||||
|
- Added `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md`
|
||||||
|
- Added `collab/questions/00-bootstrap.md` (moved from root)
|
||||||
|
- decisions:
|
||||||
|
- Defer tagging a release until first runnable wrapper exists
|
||||||
|
- next:
|
||||||
|
- Await answers in `collab/questions/00-bootstrap.md`
|
||||||
|
- Draft proposal and implementation plan once clarified
|
||||||
|
|
||||||
|
## 2025-09-17T09:05Z
|
||||||
|
- context: Housekeeping structure introduced
|
||||||
|
- actions:
|
||||||
|
- Created `collab/` directory and moved questions to `collab/questions/00-bootstrap.md`
|
||||||
|
- Added `AGENTS.md` and SeedPrompt addendum
|
||||||
|
- decisions:
|
||||||
|
- Adopt per-type subdirectories inside `collab/`
|
||||||
|
- next:
|
||||||
|
- Await answers in `collab/questions/00-bootstrap.md`
|
||||||
|
- Then proceed post-approval
|
||||||
|
|
||||||
|
## 2025-09-17T14:52Z
|
||||||
|
- context: Clarified explainers vs user answers
|
||||||
|
- actions:
|
||||||
|
- Replaced prior answers section with targeted Explainers
|
||||||
|
- next:
|
||||||
|
- Await approval to proceed
|
||||||
|
|
||||||
|
## 2025-09-17T15:00Z
|
||||||
|
- context: Token hygiene + devlog location
|
||||||
|
- actions:
|
||||||
|
- Adopted token/context hygiene rules in AGENTS.md and SeedPrompt
|
||||||
|
- Moved DevLog under `docs/devlog/`
|
||||||
|
- next:
|
||||||
|
- Keep chat minimal; log details here
|
||||||
|
|
||||||
|
## 2025-09-17T15:05Z
|
||||||
|
- context: Move devlog under docs; update references
|
||||||
|
- actions:
|
||||||
|
- Updated AGENTS.md, SeedPrompt.md to point to `docs/devlog/`
|
||||||
|
- Removed old `devlog/` files
|
||||||
|
- next:
|
||||||
|
- Continue detailed logging here; keep chat terse
|
Reference in New Issue
Block a user