11 Commits

Author SHA1 Message Date
e18cb24097 docs(changelog): add CHANGELOG.md and link from docs index
Some checks failed
Release / tag-and-notes (push) Has been cancelled
Nightly / report (push) Has been cancelled
2025-09-12 08:42:04 -05:00
ee6fed4ad2 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
2025-09-12 08:37:03 -05:00
d9c0402981 docs: point RESUME to COMMON/questions; clarify prompts output locations
Some checks failed
Release / tag-and-notes (push) Has been cancelled
Nightly / report (push) Has been cancelled
2025-09-11 07:18:10 -05:00
21a8361174 chore(repo): move DISCUSS to docs (root cleanup)
Some checks failed
Release / tag-and-notes (push) Has been cancelled
2025-09-11 07:17:38 -05:00
39ec59a356 chore(repo): remove root dist directory (area-specific packs only)
Some checks failed
Release / tag-and-notes (push) Has been cancelled
2025-09-11 07:17:12 -05:00
e33ee77db9 release: v0.0.5
Some checks failed
Release / tag-and-notes (push) Has been cancelled
2025-09-11 07:16:43 -05:00
b913a983bd chore(repo): clean root (remove misplaced docs from main)
Some checks failed
Release / tag-and-notes (push) Has been cancelled
2025-09-11 07:07:00 -05:00
1e65aadda9 release: v0.0.3
Some checks failed
Release / tag-and-notes (push) Has been cancelled
2025-09-11 07:05:23 -05:00
a00b6a8782 chore(repo): clean root and move docs
- Move docs to docs/; keep areas for prompts only
- Relocate Makefile to scripts/Makefile; update docs to use it
- Move ci.Dockerfile to docker/ci.Dockerfile; update compose
- Move commitlint config to .config and update hook
- Remove root AGENTS.md (use area AGENTS.md)
2025-09-10 18:00:50 -05:00
d381070c75 release: v0.0.2
Some checks failed
Release / tag-and-notes (push) Has been cancelled
Nightly / report (push) Has been cancelled
Squash-merge integration into main for v0.0.2
2025-09-10 22:47:49 +00:00
9cb1f5da1f Merge pull request 'release: merge integration into main' (#2) from integration into main
Some checks failed
Release / tag-and-notes (push) Has been cancelled
Reviewed-on: KNEL/LLMScaffolding#2
2025-09-10 21:50:53 +00:00
5 changed files with 74 additions and 4 deletions

12
docs/CHANGELOG.md Normal file
View 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.

View File

@@ -9,7 +9,8 @@ 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)
- Changelog: [CHANGELOG.md](CHANGELOG.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 <target>`.

58
docs/RECAP-2025-09-11.md Normal file
View File

@@ -0,0 +1,58 @@
Weekly Recap 2025-09-11
Scope
- Capture of structural, CI, and promptsystem 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 (toplevel)
- docs/ — human docs ([README](README.md), [gitworkflow](git-workflow.md), [bootstrapcicd](bootstrap-cicd.md), [docsstyle](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, repoconventions)
- 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`; precommit (format/lint/commitlint), prepush (build/test/security)
- `scripts/ci` detaches stdin for container runs to avoid prepush stdin issues
Git Workflow (recap)
- Protect `main` and `release/*`; leave `integration` unprotected (automerge on green once runners enabled)
- See [docs/gitworkflow.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/*`; automerge for PRs into `integration`
- Optionally add link checker/spellcheck to prompts/docs
- Seed CTO/COO areaspecific 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)

View File

@@ -48,6 +48,5 @@ Branches on remote
- Track in [docs/TODO.md](TODO.md): Revisit enabling runners and protected checks on 2025-09-24
10) Next tasks
- Answer any outstanding questions in questions/*
- Answer any outstanding questions in COMMON/questions/*
- On approval, implement further proposals and update instructions/*

View File

@@ -7,7 +7,7 @@ Usage: scripts/prompts <command> [args]
Commands:
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
lint Lint prompts (budgets and includes)
USAGE