armelhbobdad/bmad-module-ultracode-goal / skills/ultracode-goal
ultracode-goal
FlaggedRuns a BMAD Epic autonomously to a machine-checked Definition-of-Done. Use when the user requests to 'run an epic autonomously', 'execute this epic', 'ultracode goal', or 'autonomously deliver the epic'.
assets/ucg-awareness/shaping-decision.md
View on GitHub# UCG Awareness Fragment Shaping Decision
This is the decision-doc gate. Content adequacy of a shaping
fragment is a human judgment, so for each shaping fragment below a reviewer
(the operator, or the conductor with operator ratification batched to the
end-of-epic review) confirms that every shift-left shaping bullet for that
workflow appears as a `persistent_facts` guardrail entry, names the permanent
floor classes the fragment targets, and records an `ACCEPTED` or `REWORK`
verdict with a reviewer and a date.
Every block below is signed against the downgrade note: these fragments are
run-scoped guardrail facts, narrower than per-acceptance-criterion machine
directives by design. The formalize/preflight gate, not this shaping, is the
load-bearing guarantee that an artifact is UCG-ready. A fragment steers authoring toward
readiness; the gate still decides the verdict.
The fixed block format each entry below follows, which
`test_shaping_decision_doc_present_and_signed` parses, is:
- a `## Fragment: <fragment-id>` heading whose `<fragment-id>` is the
`[ucg:<skill>]` identity of the fragment,
- a `Fragment file:` line naming the on-disk fragment path,
- `Shift-left shaping coverage:` and `Permanent floor classes:` lines,
- and `Reviewer:`, `Date:`, `Status:` lines.
A block whose `Status:` is not `ACCEPTED`, that is missing, or whose
`Fragment file:` names a path that does not exist on disk fails the test.
## Fragment: [ucg:bmad-prd]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/bmad-prd.toml`
- Shift-left shaping coverage: machine-checkable NFR budgets (named metric, concrete
numeric/boolean threshold, measurement method); gate-ability tag on each
requirement and NFR from {ci-machine, partly-operator, decision-doc}; stable
traceable FR id on each functional requirement; resolve open questions as ADRs
before UCG/preflight rather than leaving a TBD on a load-bearing requirement.
- Permanent floor classes: invented-NFR-threshold (threshold numbers cite a source
or are marked UNKNOWN); undecided-decision (open questions resolved as ADRs
before a UCG or preflight run).
- Bound surface: the live `bmad-prd` surface only, never the deprecated
`bmad-create-prd` or `bmad-edit-prd` shims.
- Reviewer: Armel
- Date: 2026-06-25
- Status: ACCEPTED
## Fragment: [ucg:bmad-architecture]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/bmad-architecture.toml`
- Shift-left shaping coverage: each load-bearing decision authored as a numbered
architecture decision with an explicit Binds, Prevents, and Rule plus an
ADOPTED marker once settled; Deferred-with-a-revisit-trigger entries instead of
a silent TBD; resolve open questions as ADRs before preflight; decision ids stay
stable and no inherited parent decision is silently weakened; no structural
dimension the altitude owns is left wholly silent.
- Permanent floor classes: undecided-decision (unresolved or untagged forks an
in-scope story depends on); invented-NFR-threshold (architecture numbers cite
a source or are recorded Deferred-with-revisit).
- Reviewer: Armel
- Date: 2026-06-25
- Status: ACCEPTED
## Fragment: [ucg:bmad-create-epics-and-stories]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/bmad-create-epics-and-stories.toml`
- Shift-left shaping coverage: per-story gate-ability tag from {ci-machine,
partly-operator, decision-doc}; every AC a deterministic machine-checkable
assertion; each AC names a verification artifact an existing story or test
declares; a mandatory anti-vacuous twin per AC; the deterministic-CI-vs-operator
split made explicit per AC; every in-scope FR covered by at least one story
with no AC presupposing an undecided question.
- Permanent floor classes: vacuous AC; orphaned never-green index; leaked TEA
artifact (TEA outputs under the trace_output root, never the source or
implementation tree); invented NFR threshold.
- Reviewer: Armel
- Date: 2026-06-25
- Status: ACCEPTED
## Fragment: [ucg:bmad-testarch-test-design]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/bmad-testarch-test-design.toml`
- Shift-left shaping coverage: extract every NFR threshold from PRD/architecture/ADR/epic/story
and cite its source, never guess (a genuinely-unknown threshold is marked UNKNOWN and routed to a
risk/deferral); a risk matrix of genuine risks each with a unique id, category, probability x impact
score, and a mitigation on score >= 6; the score cell is the P x I product, not a free number;
honest P0-P3 priorities (TEA owns the percentages); Create + Epic-Level mode; every test-design
artifact under the configured trace_output root.
- Permanent floor classes: invented-NFR-threshold (numbers cite a source or are UNKNOWN); leaked
TEA artifact (test-design outputs under the trace_output root, never the source/impl tree).
- Reviewer: ultracode-goal conductor (machine-evidenced via test_tea_fragments.py; operator
ratification batched to the end-of-epic review)
- Date: 2026-06-26
- Status: ACCEPTED
## Fragment: [ucg:bmad-testarch-nfr]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/bmad-testarch-nfr.toml`
- Shift-left shaping coverage: reuse the test-design NFR plan as the primary source of categories and
thresholds (never re-derive/re-guess); name each category's evidence source (a PASS cites a named
source, not a bare claim); a genuinely-unknown threshold is marked UNKNOWN and routed to CONCERNS,
never asserted PASS on an unmeasured number; write nfr-assessment.md with the overallStatus the
gate reads (state it from the categories, never originate it); under the trace_output root.
- Permanent floor classes: invented-NFR-threshold; leaked TEA artifact.
- Reviewer: ultracode-goal conductor (machine-evidenced via test_tea_fragments.py; operator
ratification batched to the end-of-epic review)
- Date: 2026-06-26
- Status: ACCEPTED
## Fragment: [ucg:ucg-create-story]
- Fragment file: `skills/ultracode-goal/assets/ucg-awareness/ucg-create-story.toml`
- Shift-left shaping coverage: each story inherits the epic AC contract verbatim
(machine-checkable, named verification, mandatory anti-vacuous twin,
CI-deterministic-vs-operator split, gate-ability tag); every Task and Subtask
carries an (AC: #) back-reference and every AC has an implementing Task; Dev
Notes cite only real, resolvable source paths and real architecture-decision
ids with no invented reference or guessed threshold; the story has a definable done derivable from
its own ACs, verifications, and Tasks before ATDD handoff.
- Permanent floor classes: vacuous AC; orphaned never-green index; invented NFR
threshold; leaked TEA artifact.
- Bound surface: `ucg-create-story`, the story skill UCG ships in place of BMAD
Method's deprecated `bmad-create-story` shim, never the shim itself. Retargeted
on 2026-10-18 from `bmad-create-story` with its entries unchanged.
- Reviewer: Armel
- Date: 2026-06-25
- Status: ACCEPTED
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |