docs(recap): add weekly recap for 2025-09-11 and link from docs index
Some checks failed
Release / tag-and-notes (push) Has been cancelled
Some checks failed
Release / tag-and-notes (push) Has been cancelled
This commit is contained in:
@@ -9,7 +9,7 @@ Key Documents
|
|||||||
- Documentation style: [docs-style.md](docs-style.md)
|
- Documentation style: [docs-style.md](docs-style.md)
|
||||||
- Operational notes: [RESUME.md](RESUME.md), [TODO.md](TODO.md)
|
- Operational notes: [RESUME.md](RESUME.md), [TODO.md](TODO.md)
|
||||||
- History: [history/BOOTSTRAP.md](history/BOOTSTRAP.md)
|
- History: [history/BOOTSTRAP.md](history/BOOTSTRAP.md)
|
||||||
|
- Weekly recap: [RECAP-2025-09-11.md](RECAP-2025-09-11.md)
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
- Make targets moved to `scripts/Makefile`. Use `make -f scripts/Makefile <target>`.
|
- Make targets moved to `scripts/Makefile`. Use `make -f scripts/Makefile <target>`.
|
||||||
|
|
||||||
|
58
docs/RECAP-2025-09-11.md
Normal file
58
docs/RECAP-2025-09-11.md
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
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)
|
||||||
|
|
Reference in New Issue
Block a user