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