201 lines
6.4 KiB
Markdown
201 lines
6.4 KiB
Markdown
# Development Log (Human Readable)
|
|
|
|
Date: 2025-09-17 08:55 (UTC)
|
|
|
|
Summary:
|
|
- Bootstrapped collaboration scaffolding based on SeedPrompt.md.
|
|
- Created dev logs (LLM-optimized and human-readable) and a QUESTIONS.md file.
|
|
|
|
Details:
|
|
- Rationale: Establish clear, file-based collaboration channels (logs + questions) with minimal noise in chat.
|
|
- Scope: No functional code yet; this is setup to enable fast iteration.
|
|
|
|
Next Steps:
|
|
- Collect answers in `collab/questions/00-bootstrap.md`.
|
|
- With clarifications, propose initial design and plan for the wrapper script (crawl phase).
|
|
|
|
Notes:
|
|
- Tagging a release and using `tea` is deferred until we have a first runnable wrapper or as directed.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 09:05 (UTC)
|
|
|
|
Summary:
|
|
- Introduced `collab/` directory; moved QUESTIONS into `collab/questions/00-bootstrap.md`.
|
|
- Added `AGENTS.md`; appended housekeeping Addendum to `SeedPrompt.md`.
|
|
|
|
Details:
|
|
- Establishes consistent file-based collaboration area and naming scheme.
|
|
|
|
Next Steps:
|
|
- Await answers to bootstrap questions, then proceed after approval.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 14:52 (UTC)
|
|
|
|
Summary:
|
|
- Adjusted questions doc to replace prior “Answers/Explainers” with an “Explainers” section focused on responding to back-questions.
|
|
|
|
Next Steps:
|
|
- 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.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:20 (UTC)
|
|
|
|
Summary:
|
|
- Oriented to the repository layout and prior collaboration artifacts (00 bootstrap questions and 01 proposal).
|
|
- Created 01-round confirmation questions to secure explicit approval before planning.
|
|
|
|
Details:
|
|
- Added `collab/questions/01-codexhelper.md` and `collab/questions/01-codexhelper.llm.md` focused on confirming the proposal and minor options.
|
|
- Will not create a plan until explicitly approved per AGENTS.md sequencing rules.
|
|
|
|
Next Steps:
|
|
- Await approval in `collab/questions/01-codexhelper.md`.
|
|
- If approved, draft `collab/plan/01-codexhelper.md` and begin Phase 1 implementation.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:28 (UTC)
|
|
|
|
Summary:
|
|
- Adopted one-way progression (no returning to prior step after approval) and in-place editing per step file.
|
|
- Consolidated confirmation items into the proposal; removed redundant questions round.
|
|
|
|
Details:
|
|
- Updated AGENTS.md sequencing rules to codify one-way progression and `.llm.md` read policy.
|
|
- Added approval checklist to `collab/proposals/01-codexhelper.md` and `.llm.md`.
|
|
- Removed `collab/questions/01-codexhelper.*` to avoid back-stepping.
|
|
|
|
Next Steps:
|
|
- Await proposal approval in `collab/proposals/01-codexhelper.md`.
|
|
- Then create `collab/plan/01-codexhelper.md`.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:36 (UTC)
|
|
|
|
Summary:
|
|
- Captured the global system prompt directly (one-time exception) per request and aligned AGENTS.md to reference it.
|
|
|
|
Details:
|
|
- Added `prompts/global/system.md` and `prompts/global/system.llm.md`.
|
|
- Updated AGENTS.md to note the canonical system rules location and reinforce `.llm.md`-only reading policy and one-way progression.
|
|
|
|
Next Steps:
|
|
- Use these artifacts for all subsequent work and generated projects.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:42 (UTC)
|
|
|
|
Summary:
|
|
- Added seed AGENTS templates and a project AGENTS template for scaffolding.
|
|
|
|
Details:
|
|
- Created `meta/AGENTS.seed.md` and `meta/AGENTS.seed.llm.md` as bootstrap references.
|
|
- Created `templates/project/_shared/AGENTS.md` to be copied into new projects.
|
|
- Updated AGENTS.md to reference the seed templates.
|
|
|
|
Next Steps:
|
|
- When implementing `new-project`, copy `templates/project/_shared/AGENTS.md` into the project root.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:48 (UTC)
|
|
|
|
Summary:
|
|
- Folded `meta/` seed AGENTS and `prompts/global/` into the proposal so the upcoming plan includes them.
|
|
|
|
Details:
|
|
- Updated `collab/proposals/01-codexhelper.md` and `.llm.md` to explicitly list `meta/AGENTS.seed.*`, `templates/project/_shared/AGENTS.md`, and `prompts/global/` in repo/project layouts and acceptance criteria.
|
|
|
|
Next Steps:
|
|
- Await proposal approval; then codify in `collab/plan/01-codexhelper.md`.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 15:55 (UTC)
|
|
|
|
Summary:
|
|
- Added an explicit governance/propagation rule so that reusable workflow changes are folded into the global system prompt and AGENTS templates and reflected in proposal/plan.
|
|
|
|
Details:
|
|
- Updated `prompts/global/system.{md,llm.md}` with a Governance and Propagation section.
|
|
- Updated `meta/AGENTS.seed.*` and `templates/project/_shared/AGENTS.md` to include propagation guidance.
|
|
- Reflected this rule in `collab/proposals/01-codexhelper.{md,llm.md}`.
|
|
|
|
Next Steps:
|
|
- Apply this propagation practice for future non-project-specific instructions.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 16:00 (UTC)
|
|
|
|
Summary:
|
|
- Committed and pushed all recent changes; verified local is in sync with remote.
|
|
|
|
Details:
|
|
- Conventional Commits used; pushed to `origin main`.
|
|
- Verified `HEAD` equals `origin/main` and working tree is clean.
|
|
|
|
Next Steps:
|
|
- Await proposal approval; then draft `collab/plan/01-codexhelper.md`.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 16:05 (UTC)
|
|
|
|
Summary:
|
|
- Created Phase 1 implementation plan for CodexHelper.
|
|
|
|
Details:
|
|
- Added `collab/plan/01-codexhelper.md` and `.llm.md` with milestones, deliverables, and acceptance criteria aligned to the approved proposal.
|
|
|
|
Next Steps:
|
|
- Await plan review/approval; then start implementation.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 16:12 (UTC)
|
|
|
|
Summary:
|
|
- Incorporated TDD as a governance rule with full unit/integration tests for all features in this repo and generated projects.
|
|
|
|
Details:
|
|
- Updated `prompts/global/system.{md,llm.md}`, `meta/AGENTS.seed.*`, and `templates/project/_shared/AGENTS.md` to mandate TDD.
|
|
- Amended the proposal and plan to include TDD milestones and test coverage acceptance criteria.
|
|
|
|
Next Steps:
|
|
- Execute the plan using TDD, starting with test harness setup and failing tests.
|
|
|
|
---
|
|
|
|
Date: 2025-09-17 16:24 (UTC)
|
|
|
|
Summary:
|
|
- Added governance: zero technical debt and production-ready at all times (safety first, speed second) for this and generated projects.
|
|
|
|
Details:
|
|
- Updated system prompts and AGENTS templates to mandate zero-debt and remove any doc/test deferrals.
|
|
- Updated proposal and plan to include this rule and acceptance criteria.
|
|
|
|
Next Steps:
|
|
- Maintain zero-debt gate during implementation; no merges without tests and docs.
|