From 264687af87df9551bf363931538adb9da6c9461c Mon Sep 17 00:00:00 2001 From: David Chen Date: Mon, 14 Sep 2026 21:13:10 -0700 Subject: [PATCH] docs(agents): add shared BMAD build, QA, and checkpoint skill entrypoints --- .agents/skills/bmad-build/SKILL.md | 8 ++++++++ .agents/skills/bmad-checkpoint-preview/SKILL.md | 8 ++++++++ .agents/skills/bmad-qa/SKILL.md | 8 ++++++++ AGENTS.md | 14 ++++++++++++-- 4 files changed, 36 insertions(+), 2 deletions(-) create mode 100644 .agents/skills/bmad-build/SKILL.md create mode 100644 .agents/skills/bmad-checkpoint-preview/SKILL.md create mode 100644 .agents/skills/bmad-qa/SKILL.md diff --git a/.agents/skills/bmad-build/SKILL.md b/.agents/skills/bmad-build/SKILL.md new file mode 100644 index 0000000..df893a9 --- /dev/null +++ b/.agents/skills/bmad-build/SKILL.md @@ -0,0 +1,8 @@ +--- +name: bmad-build +description: "Implement a bounded repository change with the shared BMAD build workflow and local gates." +--- + +Read and follow `~/.codex/skills/bmad-build/SKILL.md` with this repository as the project root. +This entrypoint intentionally uses the shared personal workflow directly; do not run the legacy +BMAD renderer or adjacent workflow snapshots. Preserve this repository's authority and local gates. diff --git a/.agents/skills/bmad-checkpoint-preview/SKILL.md b/.agents/skills/bmad-checkpoint-preview/SKILL.md new file mode 100644 index 0000000..8d13941 --- /dev/null +++ b/.agents/skills/bmad-checkpoint-preview/SKILL.md @@ -0,0 +1,8 @@ +--- +name: bmad-checkpoint-preview +description: "Guide human review of a change with orientation, concern walkthrough, risk details, and observation." +--- + +Read and follow `~/.codex/skills/bmad-checkpoint-preview/SKILL.md` with this repository as the project root. +This entrypoint intentionally uses the shared personal workflow directly; do not run the legacy +BMAD renderer or adjacent workflow snapshots. Preserve this repository's authority and local gates. diff --git a/.agents/skills/bmad-qa/SKILL.md b/.agents/skills/bmad-qa/SKILL.md new file mode 100644 index 0000000..d036634 --- /dev/null +++ b/.agents/skills/bmad-qa/SKILL.md @@ -0,0 +1,8 @@ +--- +name: bmad-qa +description: "Review changes with the shared BMAD QA process and local domain gates; fix only when requested." +--- + +Read and follow `~/.codex/skills/bmad-qa/SKILL.md` with this repository as the project root. +This entrypoint intentionally uses the shared personal workflow directly; do not run the legacy +BMAD renderer or adjacent workflow snapshots. Preserve this repository's authority and local gates. diff --git a/AGENTS.md b/AGENTS.md index 89981bd..7928aae 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,8 +4,18 @@ Read `CLAUDE.md` for repository scope and authority boundaries. This repository and presentation work; GraphReFly engine and protocol authority remain in `~/src/graphrefly-ts` and `~/src/graphrefly`. -Before decision or work admission, design review, dispatch, QA, long-running goal progression, -live/provider/spend authorization, retry, or stalled-work recovery, load and follow the personal +When changing authority records or resolving an execution, spend, retry, or stalled-work +authorization boundary, load and follow the personal `$project-governance` skill at `~/.codex/skills/project-governance/SKILL.md`. This is a cross-project process floor, not package or GraphReFly product authority. Keep local IDs, records and gates independent unless an explicitly approved GraphReFly family contract requires a qualified link. + +## Shared build and human review + +Use the personal `~/.codex/skills/bmad-build/SKILL.md` inside the work selected by this repository's +dispatch/Goal workflow. Use `~/.codex/skills/bmad-build/references/qa.md` for machine-review lenses, +finding triage and repairs, together with this repository's own QA checks and completion gates. +Use `~/.codex/skills/bmad-checkpoint-preview/SKILL.md` for the human review trail; it replaces the old +repository-ownership-practice checks. Ordinary delivery uses build-handoff mode; explicit checkpoint +or `--practice` requests use interactive review. The shared skills own only this personal workflow; +project authority, semantic approvals, execution permissions and work records remain locally governed.