diff --git a/proposals/bootstrap-cicd.md b/COMMON/proposals/bootstrap-cicd.md similarity index 100% rename from proposals/bootstrap-cicd.md rename to COMMON/proposals/bootstrap-cicd.md diff --git a/questions/bootstrap-cicd.md b/COMMON/questions/bootstrap-cicd.md similarity index 100% rename from questions/bootstrap-cicd.md rename to COMMON/questions/bootstrap-cicd.md diff --git a/COO/AGENTS.md b/COO/AGENTS.md index 2686a53..00c76cf 100644 --- a/COO/AGENTS.md +++ b/COO/AGENTS.md @@ -1,6 +1,6 @@ COO Agent Pack -Use the generated pack for agents: [dist/prompts/coo.md](../../dist/prompts/coo.md). +Use the generated pack for agents: [dist/prompts/coo.md](dist/prompts/coo.md). Includes (via COMMON base): - System persona, style, safety diff --git a/CTO/AGENTS.md b/CTO/AGENTS.md index 33b9ad1..f4899ec 100644 --- a/CTO/AGENTS.md +++ b/CTO/AGENTS.md @@ -1,6 +1,6 @@ CTO Agent Pack -Use the generated pack for agents: [dist/prompts/cto.md](../../dist/prompts/cto.md). +Use the generated pack for agents: [dist/prompts/cto.md](dist/prompts/cto.md). Includes (via COMMON base): - System persona, style, safety diff --git a/README.md b/README.md index ff9297c..7f91df7 100644 --- a/README.md +++ b/README.md @@ -7,8 +7,8 @@ Layout - COMMON/ CTO/ COO/ CCO/ — questions, proposals, and prompt modules only - scripts/ — Makefile and helper scripts - docker/ — CI compose and Dockerfile -- dist/prompts/ — generated prompt packs (cto.md, coo.md) -- proposals/, questions/ — repository planning artifacts +- CTO/dist/prompts/ and COO/dist/prompts/ — generated prompt packs +- COMMON/proposals/, COMMON/questions/ — planning artifacts Quickstart - Install hooks: `make -f scripts/Makefile hooks-setup` diff --git a/docs/DISCUSS.md b/docs/DISCUSS.md new file mode 100644 index 0000000..6bec9a6 --- /dev/null +++ b/docs/DISCUSS.md @@ -0,0 +1,42 @@ +DISCUSSION – Areas, Structure, Ownership + +Context +- This repo hosts generic, foundational practices reusable across projects. +- Areas: COMMON (shared practices), CTO (shared technical standards), COO (business ops), CCO (deferred; placeholder only). + +Decisions Confirmed +- Area directories are uppercase: COMMON, CTO, COO, CCO. +- Shared practices and base guidance live under COMMON. +- CCO is deferred for now; placeholder directory only. + +Open Questions to Confirm +- Naming conventions within areas + - File naming: keep kebab-case (e.g., [COMMON/git-workflow.md](COMMON/git-workflow.md)) or use TitleCase? + - Per-area `README.md` vs. `INDEX.md` expectations. +- Scope boundaries + - COMMON: include Git workflow, CI/bootstrap parity, templates (PR/issue), documentation style guide, ADR pattern, security/privacy baselines? + - CTO: preferred tech stacks, language/runtime versions, container base image policy, local dev environment patterns (devcontainers/Make), testing strategy, quality bars? + - COO: operating rhythm (cadences, ceremonies), roles/RACI, OKR/KPI templates, onboarding, procurement/vendor-lite guidance, documentation templates? + - CCO: when in scope, include customer journey templates, support/SLA baselines, enablement playbooks, feedback loops? Any overlap rules with COO/CTO? +- Consumers and audience + - Internal only or some content public-facing? Any confidentiality/compliance constraints (esp. COO/CCO)? +- Reuse strategy + - Copy into new repos vs. reference centrally? Provide “adoption guides” per area? Offer minimal vs. advanced profiles? +- Ownership & change control + - CODEOWNERS per area? Who approves updates across COMMON/CTO/COO? + - Labels and PR templates per area; contribution guidelines? +- Document shape and standards + - Prescriptive checklists vs. narrative guidance; include “10-minute quickstart” per area? + - Standardize front‑matter, headers, and ADR structure? +- Cross‑cutting policies + - Where to maintain shared policies (security, privacy, accessibility) — under COMMON? +- CI for docs + - Keep current markdown/yaml linters repo‑wide; add link checker/spellcheck? +- Migration of existing docs + - Which existing files beyond Git workflow and CI bootstrap should move under COMMON now vs. later (e.g., proposals, questions, [RESUME.md](RESUME.md), [TODO.md](TODO.md))? + +Proposed Next Steps (pending answers) +- Seed per‑area README with scope, audiences, adoption guidance. +- Create COMMON/templates/ for reusable checklists, PR/issue templates, ADRs. +- Map/move additional shared docs into COMMON and update references. +- Define CODEOWNERS and contribution norms per area. diff --git a/docs/TODO.md b/docs/TODO.md index 14f8b66..9a70f50 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -12,7 +12,7 @@ TODO - CI/CD bootstrap - [x] Create branch bootstrap-cicd from main - - [x] Add questions at [questions/bootstrap-cicd.md](../questions/bootstrap-cicd.md) + - [x] Add questions at [COMMON/questions/bootstrap-cicd.md](../COMMON/questions/bootstrap-cicd.md) - [x] Draft proposal based on answers - [x] Implement parity tooling: scripts/ci, docker/ci.Dockerfile, docker/ci.compose.yml - [x] Add .gitea/workflows: ci.yml, release.yml, nightly.yml diff --git a/scripts/prompts b/scripts/prompts index b215478..d1fcd25 100755 --- a/scripts/prompts +++ b/scripts/prompts @@ -28,11 +28,11 @@ ci_run() { build_manifest() { local manifest=$1 out=$2 root root="$(repo_root)" - mkdir -p "$root/dist/prompts" # Write on host to avoid ownership issues; container prints to stdout. TMP_OUT=$(mktemp) trap '[[ -n "${TMP_OUT:-}" ]] && rm -f "$TMP_OUT"' EXIT ci_run "python3 scripts/prompt_build.py '$manifest' -" >"$TMP_OUT" + mkdir -p "$(dirname "$out")" mv "$TMP_OUT" "$out" } @@ -44,12 +44,12 @@ case "$cmd" in pack) shift; area=${1:-}; root="$(repo_root)" case "$area" in - cto) build_manifest "$root/COMMON/prompt/manifests/cto.yaml" "$root/dist/prompts/cto.md" ;; - coo) build_manifest "$root/COMMON/prompt/manifests/coo.yaml" "$root/dist/prompts/coo.md" ;; + cto) build_manifest "$root/COMMON/prompt/manifests/cto.yaml" "$root/CTO/dist/prompts/cto.md" ;; + coo) build_manifest "$root/COMMON/prompt/manifests/coo.yaml" "$root/COO/dist/prompts/coo.md" ;; *) echo "Unknown area: $area" >&2; exit 2 ;; esac ;; all) - root="$(repo_root)"; mkdir -p "$root/dist/prompts" + root="$(repo_root)" "$0" pack cto "$0" pack coo ;; lint)