agentleFS
cmdr-characmdr-chara/codex-toolkit/skills/verification-and-release/SKILL.md

verification-and-release

Skill2 starsChanged 11 days agoMITView on GitHub

Design risk-based verification and judge release readiness from traceable evidence. Use when deciding what must be proven or whether an integrated change can ship. Not for implementing features or diagnosing unknown failures.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 7 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use this skill for verification strategy, CI/test evidence review, operational release controls, rollout/rollback planning, or a final …

    line 12
  2. Distinctive:

    Do not trigger to implement the feature, diagnose an unknown failure, or treat a green unit suite as sufficient release evidence.

    line 14
  3. Distinctive:

    Do not mark skipped, stale, flaky, filtered, or wrong-revision checks as passing evidence.

    line 23
  4. Distinctive:

    Do not expose secrets in logs or evidence bundles.

    line 24
  5. Distinctive:

    Do not deploy or roll back production merely because this skill recommends it.

    line 25
  6. Distinctive:

    Freeze the candidate and claims: Every check must prove or challenge a specific behavioral or nonfunctional claim.

    line 29
  7. Very specific:

    Map risk: Use references/risk-test-matrix.md.

    line 30
  8. Distinctive:

    Verify operational readiness: Check applicable build artifact, configuration, migration ordering, health, flags, observability, …

    line 41
  9. Very specific:

    Issue the decision: Use references/release-evidence-schema.md.

    line 43
  10. Distinctive:

    If evidence is stale or tied to another revision, mark it stale.

    line 51
  11. Very specific:

    Stop with READY only when material claims have sufficient current evidence and rollout/rollback controls fit the risk.

    line 55

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Verification and Release

Decide release readiness from evidence proportional to consequence, novelty, blast radius, and reversibility.

Trigger boundary

Use this skill for verification strategy, CI/test evidence review, operational release controls, rollout/rollback planning, or a final READY / CONDITIONAL / BLOCKED decision.

Do not trigger to implement the feature, diagnose an unknown failure, or treat a green unit suite as sufficient release evidence.

Required inputs

Resolve the frozen candidate/ref, intended behavior, affected consumers, risk-sensitive surfaces, local/CI results, deployment topology, migrations, observability, rollback/forward-recovery, release scope, and protected user work.

Safety baseline

  • Preserve the working tree and candidate identity.
  • Do not mark skipped, stale, flaky, filtered, or wrong-revision checks as passing evidence.
  • Do not expose secrets in logs or evidence bundles.
  • Do not deploy or roll back production merely because this skill recommends it.

Workflow

  1. Freeze the candidate and claims. Every check must prove or challenge a specific behavioral or nonfunctional claim.
  2. Map risk. Use references/risk-test-matrix.md; risk comes from failure modes and reversibility, not line count.
  3. Choose minimum sufficient evidence. Static, unit/component, contract/schema, integration, end-to-end, nonfunctional, and operational layers are options, not a mandatory checklist. For user-facing behavior needing real execution, load references/project-verification.md and use a source-grounded project verification map when available. For explicitly formalized obligations, read references/formal-proof-checks.md; Bend 2 checks are only relevant to Bend 2 projects.
  4. Review CI architecture when needed. For GitHub Actions speed, trust boundaries, permissions, caching, or deploy gates, read references/github-actions.md. If independent job-local steps dominate elapsed feedback, conditionally load references/github-actions-parallelism.md and benchmark the trade-off.
  5. Collect exact results. Where JUnit/LCOV reports exist, use:
python skills/verification-and-release/scripts/summarize_test_reports.py --junit build/test-results --lcov coverage/lcov.info --format markdown

Record command, candidate, environment, pass/fail/skip/flaky state, and relevant artifacts. 6. Evaluate evidence quality. Classify material evidence as current pass, fail, gap, stale, flaky, or not applicable with reason. 7. Verify operational readiness. Check applicable build artifact, configuration, migration ordering, health, flags, observability, support/runbooks, and rollback/forward-recovery. For executable agent/skill/plugin distribution or automatic updates, read references/agent-supply-chain.md and distinguish advisory instructions from enforced policy. 8. Define rollout. State cohort/staging, kill/rollback trigger, monitoring window, and post-release verification. 9. Issue the decision. Use references/release-evidence-schema.md. Residual risk acceptance belongs to the authorized owner, not the skill.

Handoffs and interaction boundaries

Return missing feature checks to the owning builder, unknown failures to debugging-investigator, migration/rollback gaps to codebase-evolution-controller, security-first code questions to security-review, and documentation gaps to documentation-synchronizer.

Failure handling

If evidence is stale or tied to another revision, mark it stale. If CI is flaky, investigate or explicitly gap the affected claim rather than retrying until green. A critical failure stays blocking unless an authorized owner accepts a bounded residual risk with containment.

Stop conditions

Stop with READY only when material claims have sufficient current evidence and rollout/rollback controls fit the risk. Otherwise return CONDITIONAL or BLOCKED with concrete missing evidence.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.