7 Commits

Author SHA1 Message Date
667e66d657 chore(structure): area-specific dist for packs; move proposals/questions to COMMON; move DISCUSS.md to docs; update links and builder
Some checks failed
CI / checks (pull_request) Has been cancelled
2025-09-11 07:15:41 -05:00
ca8905fa4e chore(repo): clean root and move docs
Some checks failed
CI / checks (pull_request) Has been cancelled
- 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-11 07:01:24 -05:00
39b53e4554 docs: restore BOOTSTRAP.md from early bootstrap branch (traceability)
Some checks failed
CI / checks (pull_request) Has been cancelled
2025-09-10 17:45:07 -05:00
2a7d270062 docs(style): enforce clickable links for Markdown references
- Add COMMON/docs-style.md with linking rule
- Convert plain Markdown file references to relative links across docs
2025-09-10 17:43:37 -05:00
59e104a57c docs(agents): add AGENTS.md and area packs
- Add CTO/COO AGENTS.md pointing to dist prompt packs
- Add CODEOWNERS for COMMON/prompt and areas
- Add prompt_build.py used by scripts/prompts (containerized)
2025-09-10 17:39:15 -05:00
d2eb0e1f79 feat(prompts): modular agent packs and builder
- Add COMMON prompt modules + manifests (base, CTO, COO)
- Add scripts/prompts builder (runs in CI container with host uid/gid)
- Make targets: prompts, prompts-check
2025-09-10 17:34:28 -05:00
56aa2a1522 feat(org): introduce COMMON/CTO/COO/CCO areas
- Add uppercase area directories; CCO placeholder only
- Move shared docs to COMMON (git workflow, CI bootstrap); update references
- Add DISCUSS.md to capture open questions and decisions
2025-09-10 17:21:26 -05:00
5 changed files with 4 additions and 74 deletions

View File

@@ -1,12 +0,0 @@
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,8 +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)
- 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>`.

View File

@@ -1,58 +0,0 @@
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,5 +48,6 @@ 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 COMMON/questions/* - Answer any outstanding questions in questions/*
- On approval, implement further proposals and update instructions/* - On approval, implement further proposals and update instructions/*

View File

@@ -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 area dist/ pack <area> Build known area pack (cto|coo) into dist/prompts
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