This commit is contained in:
@@ -1,6 +1,6 @@
|
|||||||
COO Agent Pack
|
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):
|
Includes (via COMMON base):
|
||||||
- System persona, style, safety
|
- System persona, style, safety
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
CTO Agent Pack
|
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):
|
Includes (via COMMON base):
|
||||||
- System persona, style, safety
|
- System persona, style, safety
|
||||||
|
@@ -7,8 +7,8 @@ Layout
|
|||||||
- COMMON/ CTO/ COO/ CCO/ — questions, proposals, and prompt modules only
|
- COMMON/ CTO/ COO/ CCO/ — questions, proposals, and prompt modules only
|
||||||
- scripts/ — Makefile and helper scripts
|
- scripts/ — Makefile and helper scripts
|
||||||
- docker/ — CI compose and Dockerfile
|
- docker/ — CI compose and Dockerfile
|
||||||
- dist/prompts/ — generated prompt packs (cto.md, coo.md)
|
- CTO/dist/prompts/ and COO/dist/prompts/ — generated prompt packs
|
||||||
- proposals/, questions/ — repository planning artifacts
|
- COMMON/proposals/, COMMON/questions/ — planning artifacts
|
||||||
|
|
||||||
Quickstart
|
Quickstart
|
||||||
- Install hooks: `make -f scripts/Makefile hooks-setup`
|
- Install hooks: `make -f scripts/Makefile hooks-setup`
|
||||||
|
42
docs/DISCUSS.md
Normal file
42
docs/DISCUSS.md
Normal file
@@ -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.
|
@@ -12,7 +12,7 @@ TODO
|
|||||||
|
|
||||||
- CI/CD bootstrap
|
- CI/CD bootstrap
|
||||||
- [x] Create branch bootstrap-cicd from main
|
- [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] Draft proposal based on answers
|
||||||
- [x] Implement parity tooling: scripts/ci, docker/ci.Dockerfile, docker/ci.compose.yml
|
- [x] Implement parity tooling: scripts/ci, docker/ci.Dockerfile, docker/ci.compose.yml
|
||||||
- [x] Add .gitea/workflows: ci.yml, release.yml, nightly.yml
|
- [x] Add .gitea/workflows: ci.yml, release.yml, nightly.yml
|
||||||
|
@@ -28,11 +28,11 @@ ci_run() {
|
|||||||
build_manifest() {
|
build_manifest() {
|
||||||
local manifest=$1 out=$2 root
|
local manifest=$1 out=$2 root
|
||||||
root="$(repo_root)"
|
root="$(repo_root)"
|
||||||
mkdir -p "$root/dist/prompts"
|
|
||||||
# Write on host to avoid ownership issues; container prints to stdout.
|
# Write on host to avoid ownership issues; container prints to stdout.
|
||||||
TMP_OUT=$(mktemp)
|
TMP_OUT=$(mktemp)
|
||||||
trap '[[ -n "${TMP_OUT:-}" ]] && rm -f "$TMP_OUT"' EXIT
|
trap '[[ -n "${TMP_OUT:-}" ]] && rm -f "$TMP_OUT"' EXIT
|
||||||
ci_run "python3 scripts/prompt_build.py '$manifest' -" >"$TMP_OUT"
|
ci_run "python3 scripts/prompt_build.py '$manifest' -" >"$TMP_OUT"
|
||||||
|
mkdir -p "$(dirname "$out")"
|
||||||
mv "$TMP_OUT" "$out"
|
mv "$TMP_OUT" "$out"
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -44,12 +44,12 @@ case "$cmd" in
|
|||||||
pack)
|
pack)
|
||||||
shift; area=${1:-}; root="$(repo_root)"
|
shift; area=${1:-}; root="$(repo_root)"
|
||||||
case "$area" in
|
case "$area" in
|
||||||
cto) build_manifest "$root/COMMON/prompt/manifests/cto.yaml" "$root/dist/prompts/cto.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/dist/prompts/coo.md" ;;
|
coo) build_manifest "$root/COMMON/prompt/manifests/coo.yaml" "$root/COO/dist/prompts/coo.md" ;;
|
||||||
*) echo "Unknown area: $area" >&2; exit 2 ;;
|
*) echo "Unknown area: $area" >&2; exit 2 ;;
|
||||||
esac ;;
|
esac ;;
|
||||||
all)
|
all)
|
||||||
root="$(repo_root)"; mkdir -p "$root/dist/prompts"
|
root="$(repo_root)"
|
||||||
"$0" pack cto
|
"$0" pack cto
|
||||||
"$0" pack coo ;;
|
"$0" pack coo ;;
|
||||||
lint)
|
lint)
|
||||||
|
Reference in New Issue
Block a user