255 lines
10 KiB
Markdown
255 lines
10 KiB
Markdown
# 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
|
|
|
|
## 2025-09-17T15:10Z
|
|
- context: Strict chat output policy adopted
|
|
- actions:
|
|
- Added Chat Output Policy to AGENTS.md and SeedPrompt.md (five-line max; default message format; no diffs in chat)
|
|
- next:
|
|
- Use filesystem-first workflow; keep chat to update notices
|
|
|
|
## 2025-09-17T15:12Z
|
|
- context: Refined chat announcements scope
|
|
- actions:
|
|
- Limited chat announcements to collab/questions, collab/proposals, collab/plan only
|
|
- next:
|
|
- Announce only those; log everything else here
|
|
\n+## 2025-09-17T15:20Z
|
|
- context: Oriented to existing questions/proposal and prepared to proceed
|
|
- actions:
|
|
- Added `collab/questions/01-codexhelper.md` and `.llm.md` to confirm proposal acceptance
|
|
- decisions:
|
|
- Defer plan creation until explicit "Approved for Plan"
|
|
- next:
|
|
- Await responses in `collab/questions/01-codexhelper.md`
|
|
- On approval, create `collab/plan/01-codexhelper.md` and start implementation
|
|
|
|
## 2025-09-17T15:28Z
|
|
- context: One-way progression clarified; avoid back-stepping
|
|
- actions:
|
|
- Updated AGENTS.md with one-way progression and in-place editing rules
|
|
- Moved confirmation checklist into `collab/proposals/01-codexhelper.{md,llm.md}`
|
|
- Removed `collab/questions/01-codexhelper.*`
|
|
- next:
|
|
- Await proposal approval in `collab/proposals/01-codexhelper.md`
|
|
- Then draft `collab/plan/01-codexhelper.md`
|
|
|
|
## 2025-09-17T15:36Z
|
|
- context: One-time direct capture of global system prompt per user instruction
|
|
- actions:
|
|
- Added `prompts/global/system.md` and `prompts/global/system.llm.md`
|
|
- Updated AGENTS.md to reference and align with the global system prompt
|
|
- decisions:
|
|
- System prompt will govern agent behavior across projects; `.llm.md` used for intake, both siblings written
|
|
- next:
|
|
- Use these artifacts going forward; keep them in sync
|
|
|
|
## 2025-09-17T15:42Z
|
|
- context: Seed AGENTS templates requested for bootstrap and project scaffolding
|
|
- actions:
|
|
- Added `meta/AGENTS.seed.md` and `meta/AGENTS.seed.llm.md`
|
|
- Added `templates/project/_shared/AGENTS.md` for project scaffolding
|
|
- Updated AGENTS.md to reference the seed templates
|
|
- next:
|
|
- Include the project AGENTS.md when implementing scaffolding
|
|
|
|
## 2025-09-17T15:48Z
|
|
- context: Folded meta and prompts/global into proposal so plan will include them
|
|
- actions:
|
|
- Updated `collab/proposals/01-codexhelper.{md,llm.md}` to explicitly list `meta/` seeds, `templates/project/_shared/AGENTS.md`, and `prompts/global/`
|
|
- Added acceptance criteria ensuring AGENTS.md is copied and prompts/global is used
|
|
- next:
|
|
- Await proposal approval; then reflect these in the plan
|
|
|
|
## 2025-09-17T15:55Z
|
|
- context: Global propagation rule requested for process adjustments across projects
|
|
- actions:
|
|
- Added Governance/Propagation sections to `prompts/global/system.{md,llm.md}`
|
|
- Updated seed and project AGENTS templates to include propagation guidance
|
|
- Reflected governance/propagation in proposal files
|
|
- next:
|
|
- Use this rule for future non-project-specific changes
|
|
|
|
## 2025-09-17T16:00Z
|
|
- context: Commit and push requested; ensure clean sync
|
|
- actions:
|
|
- Committed all staged changes with Conventional Commits
|
|
- Pushed to `origin main`
|
|
- Verified local `HEAD` matches `origin/main` and working tree is clean
|
|
- result:
|
|
- HEAD: 0625682
|
|
|
|
## 2025-09-17T16:05Z
|
|
- context: Proposal approved; creating implementation plan
|
|
- actions:
|
|
- Added `collab/plan/01-codexhelper.md` and `.llm.md` with milestones, deliverables, and acceptance criteria
|
|
- next:
|
|
- Await plan review/approval; then implement per milestones
|
|
|
|
## 2025-09-17T16:12Z
|
|
- context: Governance update — adopt TDD and full unit tests across this repo and generated projects
|
|
- actions:
|
|
- Updated global system prompt and seed/project AGENTS templates to encode TDD requirement
|
|
- Amended proposal and plan to include TDD milestones and acceptance criteria
|
|
- next:
|
|
- Proceed with TDD in implementation; scaffold tests first
|
|
|
|
## 2025-09-17T16:18Z
|
|
- context: Compressed timeline — complete Phase 1 in ~8 hours
|
|
- actions:
|
|
- Updated plan with hour-by-hour accelerated timeline and deferral notes
|
|
- next:
|
|
- Begin implementation immediately upon plan approval
|
|
|
|
## 2025-09-17T16:24Z
|
|
- context: Governance update — zero technical debt, production-ready always (safety first)
|
|
- actions:
|
|
- Updated global system prompt and seed/project AGENTS templates with zero-debt rule
|
|
- Amended proposal and plan to require docs/tests with every feature; removed any doc deferrals
|
|
- next:
|
|
- Enforce zero-debt gate throughout implementation
|
|
|
|
## 2025-09-17T16:30Z
|
|
- context: Governance update — plan ahead and maintain global architecture; avoid refactors
|
|
- actions:
|
|
- Updated system prompts and AGENTS templates to encode planning/architecture rule
|
|
- Updated proposal/plan to add architecture/module map deliverable and acceptance
|
|
- next:
|
|
- Add `docs/architecture.md` early in implementation per plan
|
|
|
|
## 2025-09-17T16:38Z
|
|
- context: Root cleanliness governance and marker removal
|
|
- actions:
|
|
- Added clean-root rule to system prompts and AGENTS templates
|
|
- Removed `.codexhelper-repo`; replaced guard detection with repo-structure heuristic
|
|
- Updated CLI guardrail tests accordingly
|
|
- next:
|
|
- Keep root minimal going forward; store assets under subdirectories
|
|
|
|
## 2025-09-17T16:50Z
|
|
- context: CI/Containers governance (Gitea + Docker) and local parity
|
|
- actions:
|
|
- Added `.gitea/workflows/ci.yml` using Docker Compose
|
|
- Added `docker/compose.yml` and `docker/test/Dockerfile` with explicit names and cleanup flow
|
|
- Added `scripts/test.docker.sh` wrapper
|
|
- Propagated CI/containers rules to system prompts and AGENTS templates; updated proposal
|
|
- next:
|
|
- Ensure future features include containerized workflows and CI updates
|
|
|
|
## 2025-09-17T17:00Z
|
|
- context: Project scaffolding to include Gitea workflow and Docker artifacts
|
|
- actions:
|
|
- Added project templates: `.gitea/workflows/ci.yml`, `docker/compose.yml`, `docker/test/Dockerfile`, `scripts/test.docker.sh`
|
|
- Updated proposal and plan to require these in generated projects
|
|
- next:
|
|
- Implement new-project scaffolder to copy these templates
|
|
|
|
## 2025-09-17T17:08Z
|
|
- context: Full repository audit and immediate fixes for minor gaps
|
|
- actions:
|
|
- Added `docs/audits/2025-09-17-audit.{md,llm.md}` with findings and actions
|
|
- Added `docs/architecture.md` per plan
|
|
- Added missing project templates: `.gitignore` and `scripts/test.sh`
|
|
- next:
|
|
- Proceed with TDD to implement new-project and run
|
|
|
|
## 2025-09-17T17:12Z
|
|
- context: Branching/release strategy discussion opened — no changes yet
|
|
- actions:
|
|
- Added `collab/questions/02-branching.{md,llm.md}` with options/tradeoffs for `main` vs `WIPhax` and protection rules
|
|
- next:
|
|
- Await answers; then draft a branching plan for approval before any branch changes
|
|
|
|
## 2025-09-17T17:18Z
|
|
- context: Implement audit recommendations; add .gitignore and audit governance
|
|
- actions:
|
|
- Added scripts/audit.sh and CI audit step; updated project templates to include audit
|
|
- Updated global/system prompts and AGENTS templates with .gitignore housekeeping and regular audits policy
|
|
- Updated proposal/plan/docs to reflect audits
|
|
- next:
|
|
- Continue TDD implementation; run audits before any release tags
|
|
|
|
## 2025-09-17T17:22Z
|
|
- context: Branching plan drafted after approval (no changes applied yet)
|
|
- actions:
|
|
- Added `collab/plan/02-branching.md` and `.llm.md` choosing trunk-based model with protected `main`, short-lived branches, and migration steps
|
|
- next:
|
|
- Await plan approval; then execute branch creation/protections
|
|
|
|
## 2025-09-17T17:28Z
|
|
- context: Corrected sequencing slip (plan before proposal) and hardened governance
|
|
- actions:
|
|
- Added `collab/proposals/02-branching.{md,llm.md}` for formal approval; marked plan as pending
|
|
- Strengthened system prompts and AGENTS templates with strict approval gates and exact phrases
|
|
- Enhanced audit script to check sequencing gates and warn when pending
|
|
- next:
|
|
- Await “Approved for Plan” on 02-branching proposal before executing the plan
|
|
|
|
## 2025-09-17T17:34Z
|
|
- context: Silence chat streaming of file contents/diffs
|
|
- actions:
|
|
- Strengthened system prompts and templates with “Quiet Shell/No Streaming” rules
|
|
- Added audit advisory to flag usage of `cat`/`sed -n` in scripts
|
|
- next:
|
|
- Avoid printing file contents via shell; log details to DevLog when needed
|
|
|
|
## 2025-09-17T17:40Z
|
|
- context: Quiet is now mandatory (no toggle)
|
|
- actions:
|
|
- Updated system prompts and AGENTS templates to state quiet is required
|
|
- next:
|
|
- Continue with quiet operations and filesystem-first logging
|
|
## 2025-09-17T16:34Z
|
|
- context: Quiet tooling wrapper added; tool.log policy established
|
|
- actions:
|
|
- Added scripts/toolwrap.sh for quiet execution and failure logging to docs/devlog/tool.log
|
|
- Updated system prompts and AGENTS templates to use tool.log
|
|
- next:
|
|
- Use toolwrap for host-side orchestration commands to keep chat silent
|