Skip to content

armelhbobdad/bmad-module-ultracode-goal / skills/ultracode-goal

ultracode-goal

Flagged

Runs 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'.

FileKindSize
SKILL.mdskill md15.9 KB
assets/module-help.csvother2.1 KB
assets/module-setup.mdmarkdown5.9 KB
assets/module.yamlconfig1.9 KB
assets/ucg-awareness/bmad-architecture.tomlconfig2.5 KB
assets/ucg-awareness/bmad-create-epics-and-stories.tomlconfig3.3 KB
assets/ucg-awareness/bmad-prd.tomlconfig2.1 KB
assets/ucg-awareness/bmad-testarch-nfr.tomlconfig1.8 KB
assets/ucg-awareness/bmad-testarch-test-design.tomlconfig3.1 KB
assets/ucg-awareness/shaping-decision.mdmarkdown6.8 KB
assets/ucg-awareness/ucg-create-story.tomlconfig3.3 KB
customize.tomlconfig9.8 KB
references/define-done.mdmarkdown15.4 KB
references/execute.mdmarkdown116.7 KB
references/finalize.mdmarkdown39.2 KB
references/gate.mdmarkdown134.5 KB
references/health-check.mdmarkdown27.0 KB
references/ingest-and-scope.mdmarkdown28.2 KB
references/preflight.mdmarkdown83.6 KB
scripts/carry_build_cache.pyscript18.6 KB
scripts/claim_check.pyscript36.3 KB
scripts/drive_epic.pyexecutablescript64.1 KB
scripts/formalize_check.pyscript83.7 KB
scripts/gate_eval.pyexecutablescript67.8 KB
scripts/gate_trail.pyexecutablescript52.6 KB
scripts/headless_envelope.pyscript12.6 KB
scripts/health_check_fp.pyscript66.5 KB
scripts/hooks/budget_stop.pyexecutablescript18.7 KB
scripts/hooks/guard_pretooluse.pyexecutablescript180.1 KB
scripts/lib/mem_common.pyscript64.6 KB
scripts/link_worktree_deps.pyscript7.1 KB
scripts/mem_observation.pyscript35.5 KB
scripts/mem_recall.pyscript19.9 KB
scripts/merge_config.pyexecutablescript13.8 KB
scripts/merge_customization.pyscript18.7 KB
scripts/merge_help_csv.pyscript9.5 KB
scripts/moved_ac_check.pyscript10.0 KB
scripts/mutate_check.pyscript64.4 KB
scripts/operator_owed.pyscript17.0 KB
scripts/preflight_check.pyscript115.2 KB
scripts/probe_servers.pyscript38.7 KB
scripts/red_ids.pyscript14.0 KB
scripts/status_render.pyscript26.0 KB
scripts/story_sizing.pyexecutablescript11.7 KB
scripts/tests/bench_ucg_formalize.mdmarkdown7.3 KB
scripts/tests/fixtures/claude_mem_real_payload.jsonconfig3.4 KB
scripts/tests/fixtures/engine-6.12/README.mdmarkdown957 B
scripts/tests/fixtures/engine-6.12/config_utils.pyscript4.1 KB
scripts/tests/fixtures/engine-6.12/resolve_customization.pyexecutablescript5.1 KB
scripts/tests/fixtures/engine/README.mdmarkdown1.0 KB
scripts/tests/fixtures/engine/resolve_customization.pyexecutablescript8.0 KB
scripts/tests/fixtures/execute_pre_verification_axes.mdmarkdown29.1 KB
scripts/tests/fixtures/execute_resume_clause_no_baseline.mdmarkdown215 B
scripts/tests/fixtures/execute_run_status_preedit.mdmarkdown1.2 KB
scripts/tests/fixtures/execute_spine_end_no_escalation_fire.mdmarkdown194 B
scripts/tests/fixtures/execute_step0_baseline_no_sha.mdmarkdown1.0 KB
scripts/tests/fixtures/execute_ticker_line.mdmarkdown332 B
scripts/tests/fixtures/finalize_epic_complete_hook_no_escalation.mdmarkdown579 B
scripts/tests/fixtures/finalize_headless_output_hand_composed.mdmarkdown1.2 KB
scripts/tests/fixtures/finalize_no_graphify_section.mdmarkdown19.4 KB
scripts/tests/fixtures/floor/all_clean/impl-artifacts/7-1-clean.mdmarkdown477 B
scripts/tests/fixtures/floor/all_clean/impl-artifacts/sprint-status.yamlconfig88 B
scripts/tests/fixtures/floor/all_clean/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/all_clean/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/all_clean/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/all_clean/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/invented_threshold/impl-artifacts/61-1-threshold.mdmarkdown564 B
scripts/tests/fixtures/floor/invented_threshold/impl-artifacts/sprint-status.yamlconfig94 B
scripts/tests/fixtures/floor/invented_threshold/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/invented_threshold/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/invented_threshold/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/invented_threshold/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/invented_threshold_unknown/impl-artifacts/61-1-threshold.mdmarkdown644 B
scripts/tests/fixtures/floor/invented_threshold_unknown/impl-artifacts/sprint-status.yamlconfig94 B
scripts/tests/fixtures/floor/invented_threshold_unknown/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/invented_threshold_unknown/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/invented_threshold_unknown/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/invented_threshold_unknown/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/leaked_tea/impl-artifacts/9-1-leak.mdmarkdown475 B
scripts/tests/fixtures/floor/leaked_tea/impl-artifacts/sprint-status.yamlconfig87 B
scripts/tests/fixtures/floor/leaked_tea/impl-artifacts/test-design-9-1.mdmarkdown291 B
scripts/tests/fixtures/floor/leaked_tea/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/leaked_tea/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/leaked_tea/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/leaked_tea/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/leaked_tea_clean/impl-artifacts/9-1-leak.mdmarkdown475 B
scripts/tests/fixtures/floor/leaked_tea_clean/impl-artifacts/sprint-status.yamlconfig87 B
scripts/tests/fixtures/floor/leaked_tea_clean/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/leaked_tea_clean/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/leaked_tea_clean/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/leaked_tea_clean/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/leaked_tea_clean/tea/traceability/test-design-9-1.mdmarkdown296 B
scripts/tests/fixtures/floor/orphaned_index/impl-artifacts/10-1-orphan.mdmarkdown513 B
scripts/tests/fixtures/floor/orphaned_index/impl-artifacts/sprint-status.yamlconfig91 B
scripts/tests/fixtures/floor/orphaned_index/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/orphaned_index/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/orphaned_index/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/orphaned_index/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/orphaned_index_resolved/impl-artifacts/10-1-orphan.mdmarkdown508 B
scripts/tests/fixtures/floor/orphaned_index_resolved/impl-artifacts/10-2-helper.mdmarkdown479 B
scripts/tests/fixtures/floor/orphaned_index_resolved/impl-artifacts/sprint-status.yamlconfig120 B
scripts/tests/fixtures/floor/orphaned_index_resolved/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/orphaned_index_resolved/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/orphaned_index_resolved/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/orphaned_index_resolved/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/sourced_threshold/impl-artifacts/61-1-threshold.mdmarkdown609 B
scripts/tests/fixtures/floor/sourced_threshold/impl-artifacts/sprint-status.yamlconfig94 B
scripts/tests/fixtures/floor/sourced_threshold/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/sourced_threshold/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/sourced_threshold/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/sourced_threshold/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/unclassified_signal/impl-artifacts/12-1-signal.mdmarkdown552 B
scripts/tests/fixtures/floor/unclassified_signal/impl-artifacts/sprint-status.yamlconfig91 B
scripts/tests/fixtures/floor/unclassified_signal/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/unclassified_signal/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/unclassified_signal/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/unclassified_signal/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/unclassified_signal_removed/impl-artifacts/12-1-signal.mdmarkdown483 B
scripts/tests/fixtures/floor/unclassified_signal_removed/impl-artifacts/sprint-status.yamlconfig91 B
scripts/tests/fixtures/floor/unclassified_signal_removed/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/unclassified_signal_removed/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/unclassified_signal_removed/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/unclassified_signal_removed/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/vacuous_ac/impl-artifacts/8-1-vacuous.mdmarkdown435 B
scripts/tests/fixtures/floor/vacuous_ac/impl-artifacts/sprint-status.yamlconfig90 B
scripts/tests/fixtures/floor/vacuous_ac/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/vacuous_ac/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/vacuous_ac/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/vacuous_ac/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/floor/vacuous_ac_sound/impl-artifacts/8-1-vacuous.mdmarkdown482 B
scripts/tests/fixtures/floor/vacuous_ac_sound/impl-artifacts/sprint-status.yamlconfig90 B
scripts/tests/fixtures/floor/vacuous_ac_sound/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/floor/vacuous_ac_sound/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/floor/vacuous_ac_sound/tea/config.yamlconfig104 B
scripts/tests/fixtures/floor/vacuous_ac_sound/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/formalize/epic-clean-control/LABEL.mdmarkdown751 B
scripts/tests/fixtures/formalize/epic-clean-control/impl-artifacts/7-1-clean.mdmarkdown477 B
scripts/tests/fixtures/formalize/epic-clean-control/impl-artifacts/sprint-status.yamlconfig88 B
scripts/tests/fixtures/formalize/epic-clean-control/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/formalize/epic-clean-control/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/formalize/epic-clean-control/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/epic-clean-control/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/formalize/epic-judgment-seed/LABEL.mdmarkdown1.1 KB
scripts/tests/fixtures/formalize/epic-judgment-seed/impl-artifacts/61-1-threshold.mdmarkdown564 B
scripts/tests/fixtures/formalize/epic-judgment-seed/impl-artifacts/sprint-status.yamlconfig94 B
scripts/tests/fixtures/formalize/epic-judgment-seed/planning-artifacts/architecture-fixture.mdmarkdown236 B
scripts/tests/fixtures/formalize/epic-judgment-seed/planning-artifacts/prd-fixture.mdmarkdown225 B
scripts/tests/fixtures/formalize/epic-judgment-seed/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/epic-judgment-seed/tea/traceability/e2e-trace-summary.jsonconfig48 B
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/impl-artifacts/6-1-experience.mdmarkdown1.3 KB
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/impl-artifacts/sprint-status.yamlconfig93 B
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/planning-artifacts/architecture-fixture.mdmarkdown93 B
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/planning-artifacts/prd-fixture.mdmarkdown84 B
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/low_ratio_zero_gap_epic/tea/traceability/.keepother32 B
scripts/tests/fixtures/formalize/ready_epic/impl-artifacts/1-1-kernel.mdmarkdown848 B
scripts/tests/fixtures/formalize/ready_epic/impl-artifacts/1-2-floor.mdmarkdown538 B
scripts/tests/fixtures/formalize/ready_epic/impl-artifacts/sprint-status.yamlconfig110 B
scripts/tests/fixtures/formalize/ready_epic/planning-artifacts/architecture-fixture.mdmarkdown218 B
scripts/tests/fixtures/formalize/ready_epic/planning-artifacts/prd-fixture.mdmarkdown207 B
scripts/tests/fixtures/formalize/ready_epic/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/ready_epic/tea/traceability/e2e-trace-summary.jsonconfig49 B
scripts/tests/fixtures/formalize/remediable_epic/impl-artifacts/2-1-thin.mdmarkdown202 B
scripts/tests/fixtures/formalize/remediable_epic/impl-artifacts/sprint-status.yamlconfig87 B
scripts/tests/fixtures/formalize/remediable_epic/planning-artifacts/architecture-fixture.mdmarkdown94 B
scripts/tests/fixtures/formalize/remediable_epic/planning-artifacts/prd-fixture.mdmarkdown85 B
scripts/tests/fixtures/formalize/remediable_epic/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/remediable_epic/tea/traceability/.keepother32 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/impl-artifacts/4-1-signal.mdmarkdown546 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/impl-artifacts/sprint-status.yamlconfig89 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/planning-artifacts/architecture-fixture.mdmarkdown103 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/planning-artifacts/prd-fixture.mdmarkdown94 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/unclassified_signal_epic/tea/traceability/.keepother32 B
scripts/tests/fixtures/formalize/unreadable_epic/impl-artifacts/3-1-broken.mdbinary28 B
scripts/tests/fixtures/formalize/unreadable_epic/impl-artifacts/sprint-status.yamlconfig89 B
scripts/tests/fixtures/formalize/unreadable_epic/tea/config.yamlconfig85 B
scripts/tests/fixtures/formalize/unreadable_epic/tea/traceability/.keepother14 B
scripts/tests/fixtures/formalize/wrong_root_epic/impl-artifacts/5-1-place.mdmarkdown420 B
scripts/tests/fixtures/formalize/wrong_root_epic/impl-artifacts/prd-fixture.mdmarkdown226 B
scripts/tests/fixtures/formalize/wrong_root_epic/impl-artifacts/sprint-status.yamlconfig88 B
scripts/tests/fixtures/formalize/wrong_root_epic/planning-artifacts/architecture-fixture.mdmarkdown187 B
scripts/tests/fixtures/formalize/wrong_root_epic/tea/config.yamlconfig104 B
scripts/tests/fixtures/formalize/wrong_root_epic/tea/traceability/.keepother32 B
scripts/tests/fixtures/gate_run_the_gate_no_ticker.mdmarkdown5.7 KB
scripts/tests/fixtures/gate_trail/light/decision-log.mdmarkdown341 B
scripts/tests/fixtures/gate_trail/light/impl-artifacts/.baseline-2-4other41 B
scripts/tests/fixtures/gate_trail/light/impl-artifacts/.baseline-2-6other41 B
scripts/tests/fixtures/gate_trail/light/test-artifacts/traceability/gate-decision-2-4.jsonconfig751 B
scripts/tests/fixtures/gate_trail/light/test-artifacts/traceability/gate-decision-2-6.jsonconfig755 B
scripts/tests/fixtures/gate_trail/light/test-artifacts/traceability/trace-2-4.mdmarkdown1.4 KB
scripts/tests/fixtures/gate_trail/light/test-artifacts/traceability/trace-2-6.mdmarkdown1.3 KB
scripts/tests/fixtures/gate_trail/production/decision-log.mdmarkdown783 B
scripts/tests/fixtures/gate_trail/production/impl-artifacts/.baseline-7-1other41 B
scripts/tests/fixtures/gate_trail/production/impl-artifacts/.baseline-7-2other41 B
scripts/tests/fixtures/gate_trail/production/impl-artifacts/.baseline-7-3other41 B
scripts/tests/fixtures/gate_trail/production/test-artifacts/atdd-checklist-7-1.mdmarkdown509 B
scripts/tests/fixtures/gate_trail/production/test-artifacts/atdd-checklist-7-2.mdmarkdown300 B
scripts/tests/fixtures/gate_trail/production/test-artifacts/traceability/gate-decision-7-1.jsonconfig648 B
scripts/tests/fixtures/gate_trail/production/test-artifacts/traceability/gate-decision-7-2.jsonconfig679 B

scripts/story_sizing.py

View on GitHub
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# ///
"""Sizing arithmetic and parent-AC claim reconciliation for a story decomposition.

`references/execute.md` ("Sizing: a story too large to drive") asks for two
computations and, until this module, shipped neither:

  - the sizing ratio, which decides whether a row is implausible to drive; and
  - the claim map check, "every parent AC claimed exactly once", which the prose
    explicitly requires to be done **mechanically** rather than by eye.

Leaving the second in the prompt meant every decomposition improvised a parser.
One of those improvisations reported two false double-claims by matching the `1`
inside `REQ-1` -- a substring match where an identity match was needed. That is
the failure this module retires, and it retires it by construction: ids are
tokenized into whole tokens and compared for EQUALITY, never with `in`. `REQ-1`
and `1` are two different ids here, and no amount of shared characters makes
them the same one.

What stays in the prompt is the judgment the prose reserves: "implausible" is an
override in both directions, and which child owns which AC is an authoring
decision. This module computes the counts, the ratio and the exactly-once
reconciliation. It never decides the split.

Exit codes: 0 the claim map reconciles, 1 it does not (unclaimed, double-claimed
or unknown ids), 2 usage error. The JSON is written on 0 and 1 alike, because a
failing reconciliation is a result to read, not a crash.

With `--parent <key> --record <dir>`, a run that reconciles also writes the
split record `<dir>/.split-<key>.json`: the parent, its children in the order
given, and the claim map. `gate_eval.py --rollup` reads a decomposed parent
through its children only on that record, so it is written only once the map
reconciles, a failing run leaves any earlier record untouched, and a record it
cannot write is exit 2 with no JSON, never a traceback read as exit 1.
"""

from __future__ import annotations

import argparse
import contextlib
import json
import os
import re
import sys
from pathlib import Path

# An id is a whole token: a `<word>-<number>` form (`AC-1`, `REQ-1`, `FR-2.1`) or
# a bare number (`1`). Anchored at both ends, so a token either IS an id or is
# rejected -- there is no partial match, which is what makes the `REQ-1` vs `1`
# confusion unrepresentable rather than merely unlikely.
_ID = re.compile(r"^(?:[A-Za-z][A-Za-z0-9_]*-\d+(?:\.\d+)*|\d+)$")

_SPLIT = re.compile(r"[,\s]+")


def parse_ids(raw: str, *, field: str) -> list[str]:
    """Split a comma/whitespace separated id list into validated whole tokens.

    Rejects a token that is not a well-formed id rather than silently dropping
    it: a typo'd id that vanished would read downstream as an AC nobody claimed,
    turning a usage error into a false reconciliation failure.
    """
    tokens = [t for t in _SPLIT.split(raw.strip()) if t]
    bad = [t for t in tokens if not _ID.match(t)]
    if bad:
        raise ValueError("%s: not well-formed ids: %s" % (field, ", ".join(bad)))
    return tokens


def _dedupe(ids: list[str]) -> tuple[list[str], list[str]]:
    """Preserve order, and report ids repeated WITHIN one list separately."""
    seen: dict[str, int] = {}
    for i in ids:
        seen[i] = seen.get(i, 0) + 1
    return list(seen), sorted(i for i, n in seen.items() if n > 1)


def reconcile(parent_acs: list[str], children: dict[str, list[str]]) -> dict:
    """Map each parent AC to the children claiming it, by token equality."""
    parent_unique, parent_dupes = _dedupe(parent_acs)
    parent_set = set(parent_unique)

    claims: dict[str, list[str]] = {ac: [] for ac in parent_unique}
    unknown: dict[str, list[str]] = {}
    for child, claimed in children.items():
        for ac in claimed:
            if ac in parent_set:
                if child not in claims[ac]:
                    claims[ac].append(child)
            else:
                unknown.setdefault(child, []).append(ac)

    unclaimed = [ac for ac in parent_unique if not claims[ac]]
    double = [ac for ac in parent_unique if len(claims[ac]) > 1]
    return {
        "claims": claims,
        "unclaimed": unclaimed,
        "double_claimed": double,
        "unknown_claims": unknown,
        "parent_ac_duplicates": parent_dupes,
        "exactly_once": not (unclaimed or double or unknown or parent_dupes),
    }


def size(ac_count: int, task_count: int, turn_ceiling: int | None) -> dict:
    """The first-pass implausibility test execute.md states.

    Implausible once the AC count reaches roughly half the per-story turn
    ceiling. The task count is reported for the tie-break and never added: a
    task list also holds steps every row pays (reading skills, running gates),
    and criteria plus tasks flagged most rows a real project then drove whole.
    With no ceiling supplied the ratio is undecidable, so `implausible` is None
    -- never False, which would read as "checked, fine".
    """
    if not turn_ceiling:
        return {
            "ac_count": ac_count,
            "task_count": task_count,
            "turn_ceiling": None,
            "ratio": None,
            "implausible": None,
        }
    return {
        "ac_count": ac_count,
        "task_count": task_count,
        "turn_ceiling": turn_ceiling,
        "ratio": round(ac_count / turn_ceiling, 4),
        "implausible": ac_count >= turn_ceiling / 2,
    }


def _parse_child(spec: str) -> tuple[str, list[str]]:
    if "=" not in spec:
        raise ValueError("--child expects <row-id>=<ac,ac,...>, got: %s" % spec)
    row, _, claimed = spec.partition("=")
    row = row.strip()
    if not row:
        raise ValueError("--child is missing the row id: %s" % spec)
    return row, parse_ids(claimed, field="--child %s" % row)


def _write_record(
    record: Path, parent: str, parent_acs: list[str], children: dict[str, list[str]]
) -> None:
    """The split record: the parent, its children in the order given, and the claim map.

    Written to a temporary file beside it and moved into place, so a write that
    fails leaves an earlier record whole rather than truncated.
    """
    staged = record.with_name(record.name + ".tmp")
    try:
        staged.write_text(
            json.dumps(
                {
                    "parent": parent,
                    "children": list(children),
                    "parent_acs": parent_acs,
                    "claims": children,
                },
                indent=2,
            )
            + "\n",
            encoding="utf-8",
        )
        os.replace(staged, record)
    except OSError:
        with contextlib.suppress(OSError):
            staged.unlink()
        raise


def _record_parent(
    args: argparse.Namespace, parent_acs: list[str], children: dict[str, list[str]]
) -> str | None:
    """The parent key a split record is written for, or None when none is asked for.

    The flags come as a pair, and a record names a split, so it needs the
    parent's ACs and children that each claim one, none of which may be the
    parent itself, and a directory to land in. A map with no ACs reconciles
    trivially, and the record would then assert a split nothing checked.
    """
    if args.parent is None and args.record is None:
        return None
    if args.parent is None or args.record is None:
        raise ValueError("--parent and --record go together")
    parent = args.parent.strip()
    if not parent or "/" in parent or "\\" in parent:
        raise ValueError("--parent expects the parent row's sprint-status key, got: %r" % args.parent)
    if not children:
        raise ValueError("--record writes a split, so it needs at least one --child")
    if not parent_acs:
        raise ValueError("--record writes a checked split, so it needs --parent-acs")
    unclaiming = [row for row, claimed in children.items() if not claimed]
    if unclaiming:
        raise ValueError("--record: --child claims no AC: %s" % ", ".join(unclaiming))
    if parent in children:
        raise ValueError("--parent %s is also given as a --child" % parent)
    if not Path(args.record).is_dir():
        raise ValueError("--record expects an existing directory, got: %s" % args.record)
    return parent


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(
        description=(
            "Size a story row and reconcile a decomposition's parent-AC claim "
            "map. Every parent AC must be claimed exactly once."
        ),
        epilog=(
            "example: story_sizing.py --parent-acs 'AC-1,AC-2,REQ-1' "
            "--child '7-1a=AC-1,AC-2' --child '7-1b=REQ-1' --tasks 4 "
            "--turn-ceiling 25"
        ),
    )
    parser.add_argument(
        "--parent-acs",
        default="",
        help="the parent row's acceptance criteria ids, comma or space separated",
    )
    parser.add_argument(
        "--child",
        action="append",
        default=[],
        metavar="ROW=ACS",
        help="one child row and the parent ACs it claims; repeatable",
    )
    parser.add_argument(
        "--tasks",
        type=int,
        default=0,
        help="task count on the row; reported for the tie-break, never added to the threshold",
    )
    parser.add_argument(
        "--turn-ceiling",
        type=int,
        default=None,
        help="{workflow.max_turns_per_story}; omit to skip the implausibility test",
    )
    parser.add_argument(
        "--parent",
        default=None,
        metavar="KEY",
        help="the parent row's sprint-status key, which names the split record "
        "(--record only)",
    )
    parser.add_argument(
        "--record",
        default=None,
        metavar="DIR",
        help="{workflow.implementation_artifacts}: when the claim map reconciles, "
        "write the split record .split-<parent>.json there, which gate_eval.py "
        "--rollup reads the parent through its children by; needs --parent, "
        "--parent-acs, and --child rows that each claim an AC",
    )
    return parser


def main(argv: list[str] | None = None) -> int:
    parser = build_parser()
    args = parser.parse_args(argv)

    try:
        parent_acs = parse_ids(args.parent_acs, field="--parent-acs")
        parsed = [_parse_child(spec) for spec in args.child]
        rows = [row for row, _ in parsed]
        repeated = sorted({row for row in rows if rows.count(row) > 1})
        if repeated:
            # Merging them would keep the last claims and drop the rest, so a
            # double claim or an unknown id in the dropped ones would vanish
            # from the check, and from the split record written on it.
            raise ValueError("--child given more than once for: %s" % ", ".join(repeated))
        children = dict(parsed)
        parent = _record_parent(args, parent_acs, children)
    except ValueError as exc:
        print("usage error: %s" % exc, file=sys.stderr)
        return 2

    result = size(len(set(parent_acs)), args.tasks, args.turn_ceiling)
    # Reconciliation only means something once a split exists. Sizing alone is
    # the pre-decomposition call, and it must not report a clean claim map it
    # never checked.
    result["reconciled"] = bool(children)
    result.update(reconcile(parent_acs, children) if children else {})
    if parent is not None:
        result["record"] = None
        if result["exactly_once"]:
            record = Path(args.record) / (".split-%s.json" % parent)
            try:
                _write_record(record, parent, parent_acs, children)
            except OSError as exc:
                print("error: cannot write the split record %s: %s" % (record, exc), file=sys.stderr)
                return 2
            result["record"] = str(record)

    print(json.dumps(result, indent=2, sort_keys=True))
    if children and not result["exactly_once"]:
        return 1
    return 0


if __name__ == "__main__":
    sys.exit(main())
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall