From f0f18181ff98fe3b78df4b72ee3c9cc27cc467fe 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 cb2bd14..b1c097a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,8 +4,18 @@ This repository owns its Solid binding and package-local work. GraphReFly engine cross-project authority remain in `~/src/graphrefly-ts` and `~/src/graphrefly`; do not duplicate them here. -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.