Compare commits
11 Commits
bootstrap-
...
main
Author | SHA1 | Date | |
---|---|---|---|
e18cb24097 | |||
ee6fed4ad2 | |||
d9c0402981 | |||
21a8361174 | |||
39ec59a356 | |||
e33ee77db9 | |||
b913a983bd | |||
1e65aadda9 | |||
a00b6a8782 | |||
d381070c75 | |||
9cb1f5da1f |
12
docs/CHANGELOG.md
Normal file
12
docs/CHANGELOG.md
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
Changelog
|
||||||
|
|
||||||
|
v0.0.1-Bootstrap — 2025-09-11
|
||||||
|
- Clean root: only README/LICENSE, allowed dotfiles, and directories.
|
||||||
|
- Docs consolidated under docs/ with clickable links.
|
||||||
|
- COMMON/CTO/COO/CCO reserved for prompts, questions, and proposals.
|
||||||
|
- Modular prompt packs: COMMON base + area manifests; packs in CTO/dist/prompts and COO/dist/prompts.
|
||||||
|
- CI image at docker/ci.Dockerfile; compose at docker/ci.compose.yml.
|
||||||
|
- Make targets in scripts/Makefile; hooks installed via scripts/setup-hooks.
|
||||||
|
- Commitlint config in .config/commitlint.config.cjs; hook updated.
|
||||||
|
- Tags/releases reset to this baseline; previous tags removed.
|
||||||
|
|
@@ -9,7 +9,8 @@ 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)
|
||||||
|
- Changelog: [CHANGELOG.md](CHANGELOG.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)
|
||||||
|
|
@@ -48,6 +48,5 @@ Branches on remote
|
|||||||
- Track in [docs/TODO.md](TODO.md): Revisit enabling runners and protected checks on 2025-09-24
|
- Track in [docs/TODO.md](TODO.md): Revisit enabling runners and protected checks on 2025-09-24
|
||||||
|
|
||||||
10) Next tasks
|
10) Next tasks
|
||||||
- Answer any outstanding questions in questions/*
|
- Answer any outstanding questions in COMMON/questions/*
|
||||||
- On approval, implement further proposals and update instructions/*
|
- On approval, implement further proposals and update instructions/*
|
||||||
|
|
||||||
|
@@ -7,7 +7,7 @@ Usage: scripts/prompts <command> [args]
|
|||||||
|
|
||||||
Commands:
|
Commands:
|
||||||
build <manifest> <output> Build a flattened prompt from a manifest
|
build <manifest> <output> Build a flattened prompt from a manifest
|
||||||
pack <area> Build known area pack (cto|coo) into dist/prompts
|
pack <area> Build known area pack (cto|coo) into area dist/
|
||||||
all Build all known area packs
|
all Build all known area packs
|
||||||
lint Lint prompts (budgets and includes)
|
lint Lint prompts (budgets and includes)
|
||||||
USAGE
|
USAGE
|
||||||
|
Reference in New Issue
Block a user