Try1-Save-LLMScaffolding/docs/RECAP-2025-09-11.md

Weekly Recap – 2025-09-11

Scope

• Capture of structural, CI, and prompt‑system work to resume quickly next week.

Highlights

• Clean root policy enforced: only README.md, LICENSE, allowed dotfiles, and directories.
• Docs consolidated under docs/ with clickable relative links.
• Areas (COMMON/CTO/COO/CCO) reserved for prompts, questions, and proposals.
• Modular prompt packs: COMMON modules + CTO/COO manifests; builder runs in container with host fallback.
• CI image moved to docker/ci.Dockerfile; compose updated.
• Make targets moved to scripts/Makefile.
• Commitlint config moved to .config/commitlint.config.cjs; hook updated.
• Baseline tag and release: v0.0.1-Bootstrap from current main; all other tags/releases removed.

Current Layout (top‑level)

• docs/ — human docs (README, git‑workflow, bootstrap‑cicd, docs‑style, RESUME, TODO, DISCUSS, history)
• COMMON/ — prompts ([prompt/*]), questions (../COMMON/questions), proposals (../COMMON/proposals)
• CTO/ — AGENTS.md, packs in CTO/dist/prompts
• COO/ — AGENTS.md, packs in COO/dist/prompts
• docker/ — compose + CI Dockerfile
• scripts/ — Makefile, hooks, CI, prompts builder

Prompt System

• Modules in COMMON/prompt/modules/* (persona, style, safety, tools, planning, execution, repo‑conventions)
• Manifests in COMMON/prompt/manifests/* (base, cto, coo)
• Packs built to CTO/dist/prompts/cto.md and COO/dist/prompts/coo.md
• Builder: scripts/prompts calls scripts/prompt_build.py
  • Runs inside CI container; falls back to host if container stdout is empty
  • No PyYAML dependency (minimal manifest parser)

CI/Tooling

• CI Dockerfile at docker/ci.Dockerfile (shellcheck, shfmt, hadolint, actionlint, yamllint, prettier/markdownlint/commitlint)
• Compose at docker/ci.compose.yml mounts repo at /workspace
• Hooks via scripts/setup-hooks; pre‑commit (format/lint/commitlint), pre‑push (build/test/security)
• scripts/ci detaches stdin for container runs to avoid pre‑push stdin issues

Git Workflow (recap)

• Protect main and release/*; leave integration unprotected (auto‑merge on green once runners enabled)
• See docs/git‑workflow.md

Tags/Releases

• Present: v0.0.1-Bootstrap only (current clean baseline)
• Removed: v0.0.2/3/4/5 and their releases

Next Steps (recommended)

• Enable Gitea Actions runner; add protected checks on main/release/*; auto‑merge for PRs into integration
• Optionally add link checker/spellcheck to prompts/docs
• Seed CTO/COO area‑specific modules (small deltas from COMMON)
• Consider docs/CHANGELOG.md; for now, this recap is the source

Quick Resume Checklist

1. Pull: git fetch --all --prune && git switch main && git pull
2. Install hooks: make -f scripts/Makefile hooks-setup
3. Rebuild packs: make -f scripts/Makefile prompts
4. Run checks: make -f scripts/Makefile check
5. Start with docs/DISCUSS.md and docs/TODO.md