59 lines
3.1 KiB
Markdown
59 lines
3.1 KiB
Markdown
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)
|
||
|