From ee6fed4ad283ab33310e4ffd1ce5bde50713f61e Mon Sep 17 00:00:00 2001 From: ReachableCEO Date: Fri, 12 Sep 2025 08:37:03 -0500 Subject: [PATCH] docs(recap): add weekly recap for 2025-09-11 and link from docs index --- docs/README.md | 2 +- docs/RECAP-2025-09-11.md | 58 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+), 1 deletion(-) create mode 100644 docs/RECAP-2025-09-11.md diff --git a/docs/README.md b/docs/README.md index bab21ea..3c0d311 100644 --- a/docs/README.md +++ b/docs/README.md @@ -9,7 +9,7 @@ Key Documents - Documentation style: [docs-style.md](docs-style.md) - Operational notes: [RESUME.md](RESUME.md), [TODO.md](TODO.md) - History: [history/BOOTSTRAP.md](history/BOOTSTRAP.md) + - Weekly recap: [RECAP-2025-09-11.md](RECAP-2025-09-11.md) Usage - Make targets moved to `scripts/Makefile`. Use `make -f scripts/Makefile `. - diff --git a/docs/RECAP-2025-09-11.md b/docs/RECAP-2025-09-11.md new file mode 100644 index 0000000..735983c --- /dev/null +++ b/docs/RECAP-2025-09-11.md @@ -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) +