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](README.md), [git‑workflow](git-workflow.md), [bootstrap‑cicd](bootstrap-cicd.md), [docs‑style](docs-style.md), [RESUME](RESUME.md), [TODO](TODO.md), [DISCUSS](DISCUSS.md), history)
- COMMON/ — prompts ([prompt/*]), questions ([../COMMON/questions](../COMMON/questions/)), proposals ([../COMMON/proposals](../COMMON/proposals/))
- CTO/ — [AGENTS.md](../CTO/AGENTS.md), packs in [CTO/dist/prompts](../CTO/dist/prompts)
- COO/ — [AGENTS.md](../COO/AGENTS.md), packs in [COO/dist/prompts](../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](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](DISCUSS.md) and [docs/TODO.md](TODO.md)