mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-16 05:56:30 +03:00
aa893e3ec2
* feat(bundles): add bundle manifest schema, manifests, and validation (#203) Introduce a machine-readable composition contract for canonical bundles: purpose, audience, stages, included skills, prerequisites, outputs, handoffs, conflicts, and eval suite (schemas/bundle-manifest-v1.schema.json, following the evals-v1 versioned-schema convention). Ship the bounded design note (docs/bundle-manifest-design.md), a schema-conformant example, canonical manifests for the three new milestone bundles, and a stdlib-only validator (scripts/validate-bundles.rb) that rejects incomplete, contradictory, and undeclared-overlapping manifests while keeping bundles an optional layer. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> * feat(bundles): add lifecycle capability matrix generator and validators (#203) Add scripts/gen-lifecycle-matrix.rb, which deterministically produces the human-readable docs/lifecycle-capability-matrix.md (one row per canonical bundle) and the machine-readable docs/lifecycle-capability-matrix.json (with per-cell source provenance) reusing the gen-*.rb conventions. Add scripts/validate-lifecycle-matrix.rb to check bundle coverage, cell traceability, artifact currency, and catalog-exactness of nested bundle helpers. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> * test(bundles): add bundle manifest validation tests (#203) Add scripts/test-validate-bundles.rb covering schema conformance of the committed example, valid-manifest and declared-conflict positives, per-field incomplete-manifest rejections, contradictory-manifest rejections (missing skill, undeclared handoff artifact, non-catalog conflict), undeclared-overlap rejection naming both manifests, and matrix generator/validator completeness and drift detection. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> * ci(bundles): wire bundle manifest validation into the gate (#203) Add validate-bundles.rb, test-validate-bundles.rb, the lifecycle matrix generator check, and the matrix validator to .github/workflows/validate.yml alongside the existing validator steps. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> --------- Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
40 KiB
40 KiB
Lifecycle Capability Matrix
Deterministically generated by scripts/gen-lifecycle-matrix.rb (schema version 1).
Every matrix entry derives from a declared bundle manifest field or a documented
derivation; see bundle-manifest-design.md for the schema,
the migration path, and the field definitions. Regenerate with
ruby scripts/gen-lifecycle-matrix.rb --write.
Summary
| Bundle | Purpose | Audience | Lifecycle stages | Included skills | Prerequisites | Outputs | Handoffs | Conflicts | Eval suite |
|---|---|---|---|---|---|---|---|---|---|
| agent-production-operations | Operate an evaluated agent with tools and authority in production through a runtime control plane covering versioning, staged rollout, fallback, cost and latency budgets, tool health, human escalation, disablement, and trace-to-eval feedback. | Agent operators and platform teams running evaluated agents with tools and delegated authority in production; agents that need the runtime control decisions between evaluation, release, SRE, security, and platform specialists. | Contract definition → Versioning and rollout planning → Staged rollout → Runtime monitoring → Trace-to-eval feedback → Learning and disablement | agent-evals-and-observability, release-engineering, site-reliability-engineering, secure-software-engineering, platform-engineering, production-readiness, incident-learning, privacy-engineering | Agent evaluation results and observability instrumentation(agent-evals-and-observability); Production-readiness evidence (go/no-go/defer/exception outcomes)(production-readiness); Incident-learning records (verified closure, follow-up work map)(incident-learning); Release pipeline and artifact promotion baseline(release-engineering) | agent-production-contract, runtime-control-plan, staged-rollout-plan, tool-authority-health-record, trace-to-eval-feedback-loop, disablement-record | staged-rollout-plan → release-engineering; trace-to-eval-feedback-loop → agent-evals-and-observability; tool-authority-health-record → incident-learning; disablement-record → human operator | production-readiness (with production-excellence); production-readiness (with product-lifecycle); release-engineering (with production-excellence); release-engineering (with product-lifecycle); site-reliability-engineering (with production-excellence); site-reliability-engineering (with product-lifecycle); secure-software-engineering (with production-excellence); secure-software-engineering (with product-lifecycle); platform-engineering (with production-excellence); platform-engineering (with product-lifecycle); incident-learning (with production-excellence); privacy-engineering (with product-lifecycle) | evals/evals.json |
| neckbeard | Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request (issue, ticket, or request) from intake through planning, gates, implementation, review, verified PR, and authorized post-merge release. neckbeard routes the change through framing, discovery, design, implementation, review, verification, delivery, and learning — choosing the smallest safe intervention, proving it at the real delivery boundary, and leaving an inspectable evidence ledger. For change-request / issue-to-PR work, conditionally loads a 9-phase journey with gates, delivery packet, and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona, not a '10x developer' prompt, not a LOC-minimizer. The journey is not loaded for plain fixes, refactors, or reviews that lack an issue/ticket trajectory. | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path |
| product-lifecycle | Route a product through its full lifecycle — discovery, strategy and portfolio choice, roadmap, UX and requirements, experimentation, delivery handoff, adoption, success, and lifecycle review — by composing existing specialist product skills with phase-entry evidence, handoff artifacts, and escalation rules. | Product managers, product operations, and portfolio teams navigating a product across multiple lifecycle phases; agents that need to know which specialist skill to load at each phase and what evidence to hand off to the next phase. | Discovery → Strategy and portfolio choice → Roadmap → UX and requirements → Experimentation → Delivery handoff → Adoption → Success → Lifecycle review | product-discovery, product-strategy, strategy-frameworks, product-roadmapping-and-portfolio, product-design-and-ux, product-experimentation, implementation-planning, production-readiness, release-engineering, product-adoption, product-analytics-and-measurement, conditional-customer-success, product-lifecycle-learning, product-methodology, product-operations-and-governance, financial-modeling, go-to-market, data-scientist, spec-driven-development, privacy-engineering, secure-software-engineering, verification-methodology, qa-methodology, site-reliability-engineering, platform-engineering, neckbeard | Product idea, market signal, or stakeholder request; Problem statement and discovery log(product-discovery); Strategic assessment and portfolio decision(product-strategy); Roadmap entry and bet record(product-roadmapping-and-portfolio); UX contracts and acceptance criteria(product-design-and-ux); Experiment readout and assumptions register(product-experimentation) | lifecycle-evidence-ledger, problem-statement, strategic-assessment, roadmap-entry, interface-contracts, experiment-brief, implementation-plan, readiness-verdict, release-plan, adoption-plan, outcome-measurement, outcome-review, lifecycle-decision | readiness-verdict → production-excellence bundle; implementation-plan → delivery team; lifecycle-evidence-ledger → next phase (via evidence ledger); lifecycle-decision → product-lifecycle-learning | production-readiness (with production-excellence); production-readiness (with agent-production-operations); release-engineering (with production-excellence); release-engineering (with agent-production-operations); site-reliability-engineering (with production-excellence); site-reliability-engineering (with agent-production-operations); secure-software-engineering (with production-excellence); secure-software-engineering (with agent-production-operations); platform-engineering (with production-excellence); platform-engineering (with agent-production-operations); privacy-engineering (with agent-production-operations); qa-methodology (with production-excellence); verification-methodology (with production-excellence) | evals/evals.json |
| production-excellence | Route cross-domain production evidence (readiness, migration, recovery, capacity/cost, incident-learning) into a launch or operational decision — go, no-go, defer, exception, or escalation — with an accountable owner and a post-launch learning path. | Service owners, SRE, release, platform, security, data, and QA teams coordinating a production change; agents assembling cross-domain production evidence into a defensible launch decision without re-deriving specialist runbooks. | Cross-domain evidence assembly → Gate evaluation → Operational handoff → Post-launch learning | production-readiness, migration-engineering, resilience-and-recovery, capacity-and-cost-engineering, incident-learning, site-reliability-engineering, release-engineering, platform-engineering, secure-software-engineering, data-engineering, qa-methodology, verification-methodology | Readiness review evidence packet (risk-scaled, 11 categories)(production-readiness); Migration plan, compatibility windows, and reconciliation evidence(migration-engineering); Resilience and recovery evidence (RTO/RPO, restore tests, game days)(resilience-and-recovery); Capacity and cost model evidence (demand, scaling, unit cost)(capacity-and-cost-engineering); Incident history, causal hypotheses, and verified-closure records(incident-learning); SLO and error-budget status(site-reliability-engineering); Release plan and rollback strategy(release-engineering) | gate-decision, operational-handoff-record, accountable-owner-record, evidence-gap-register | operational-handoff-record → incident-learning; operational-handoff-record → product-lifecycle-learning; gate-decision → agent-production-operations; accountable-owner-record → service owner | production-readiness (with product-lifecycle); production-readiness (with agent-production-operations); release-engineering (with product-lifecycle); release-engineering (with agent-production-operations); site-reliability-engineering (with product-lifecycle); site-reliability-engineering (with agent-production-operations); secure-software-engineering (with product-lifecycle); secure-software-engineering (with agent-production-operations); platform-engineering (with product-lifecycle); platform-engineering (with agent-production-operations); incident-learning (with agent-production-operations); qa-methodology (with product-lifecycle); verification-methodology (with product-lifecycle) | evals/evals.json |
| research-and-vault | Chain web research, atomic extraction, and durable knowledge capture into a repeatable workflow when the same research-to-notes sequence is needed. | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path |
| tailscale | Self-hosted Tailscale/Headscale ecosystem: deploy and manage a Headscale control server, configure tailscale clients, manage ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure. | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path |
| workflow-architect | Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path | migration deferred — see docs/bundle-manifest-design.md §Migration path |
Details
agent-production-operations
- Derivation:
manifest— source:bundles/agent-production-operations/manifest.yaml - Purpose: Operate an evaluated agent with tools and authority in production through a runtime control plane covering versioning, staged rollout, fallback, cost and latency budgets, tool health, human escalation, disablement, and trace-to-eval feedback.
- Audience: Agent operators and platform teams running evaluated agents with tools and delegated authority in production; agents that need the runtime control decisions between evaluation, release, SRE, security, and platform specialists.
- Stages (ordered):
- Contract definition — agent-evals-and-observability (
../../agent-evals-and-observability/SKILL.md), production-readiness (../../production-readiness/SKILL.md), incident-learning (../../incident-learning/SKILL.md) - Versioning and rollout planning — release-engineering (
../../release-engineering/SKILL.md), platform-engineering (../../platform-engineering/SKILL.md) - Staged rollout — platform-engineering (
../../platform-engineering/SKILL.md), site-reliability-engineering (../../site-reliability-engineering/SKILL.md) - Runtime monitoring — site-reliability-engineering (
../../site-reliability-engineering/SKILL.md), secure-software-engineering (../../secure-software-engineering/SKILL.md) - Trace-to-eval feedback — agent-evals-and-observability (
../../agent-evals-and-observability/SKILL.md) - Learning and disablement — incident-learning (
../../incident-learning/SKILL.md), production-readiness (../../production-readiness/SKILL.md), privacy-engineering (../../privacy-engineering/SKILL.md)
- Contract definition — agent-evals-and-observability (
- Included skills:
- agent-evals-and-observability (
../../agent-evals-and-observability/SKILL.md) - release-engineering (
../../release-engineering/SKILL.md) - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) - secure-software-engineering (
../../secure-software-engineering/SKILL.md) - platform-engineering (
../../platform-engineering/SKILL.md) - production-readiness (
../../production-readiness/SKILL.md) - incident-learning (
../../incident-learning/SKILL.md) - privacy-engineering (
../../privacy-engineering/SKILL.md)
- agent-evals-and-observability (
- Prerequisites:
- Agent evaluation results and observability instrumentation — via agent-evals-and-observability (
../../agent-evals-and-observability/SKILL.md) - Production-readiness evidence (go/no-go/defer/exception outcomes) — via production-readiness (
../../production-readiness/SKILL.md) - Incident-learning records (verified closure, follow-up work map) — via incident-learning (
../../incident-learning/SKILL.md) - Release pipeline and artifact promotion baseline — via release-engineering (
../../release-engineering/SKILL.md)
- Agent evaluation results and observability instrumentation — via agent-evals-and-observability (
- Outputs: agent-production-contract, runtime-control-plan, staged-rollout-plan, tool-authority-health-record, trace-to-eval-feedback-loop, disablement-record
- Handoffs:
- staged-rollout-plan → release-engineering — Rollout stages and promotion gates integrate with the release pipeline; rollback triggers tie agent health to release mechanics.
- trace-to-eval-feedback-loop → agent-evals-and-observability — Production traces and incidents feed new evaluation cases and release-gate updates.
- tool-authority-health-record → incident-learning — Tool-failure and authority-breach records feed post-incident analysis and verified-closure tracking.
- disablement-record → human operator — Disablement revokes credentials, removes the agent from routing/load-balancing, and records the reason, timestamp, and authorizing evidence.
- Conflicts:
- production-readiness (
../../production-readiness/SKILL.md) with production-excellence — Both bundles include production-readiness. This bundle consumes readiness outcomes as authority-gating inputs; production-excellence produces the go/no-go/defer/exception decisions. - production-readiness (
../../production-readiness/SKILL.md) with product-lifecycle — Both bundles include production-readiness. Route phase 6 delivery readiness reviews to product-lifecycle; runtime authority decisions for an agent in production go to this bundle. - release-engineering (
../../release-engineering/SKILL.md) with production-excellence — Release engineering is shared. Route by context: agent staged-rollout planning (this bundle) versus launch-gate release plans (production-excellence). - release-engineering (
../../release-engineering/SKILL.md) with product-lifecycle — Release engineering is shared. Route by context: agent staged-rollout planning (this bundle) versus lifecycle delivery handoff (product-lifecycle). - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with production-excellence — SRE is shared. This bundle uses it for runtime latency/cost budgets and incident handoff; production-excellence uses it for gate-entry reliability evidence. Incident command stays with SRE in both cases. - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with product-lifecycle — SRE is shared. This bundle uses it for agent runtime budgets; product-lifecycle routes to it for delivery reliability. - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with production-excellence — Security engineering is shared. Route by context: agent authority contracts and disablement security (this bundle) versus launch-gate security evidence (production-excellence). - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with product-lifecycle — Security engineering is shared. Route by context: agent trust-boundary and disablement security (this bundle) versus lifecycle-phase security needs (product-lifecycle). - platform-engineering (
../../platform-engineering/SKILL.md) with production-excellence — Platform engineering is shared. Route by context: agent sandboxing and tool-execution isolation (this bundle) versus launch-gate platform evidence (production-excellence). - platform-engineering (
../../platform-engineering/SKILL.md) with product-lifecycle — Platform engineering is shared. Route by context: agent sandboxing and tool-execution isolation (this bundle) versus lifecycle delivery handoff (product-lifecycle). - incident-learning (
../../incident-learning/SKILL.md) with production-excellence — Both bundles consume incident-learning records. This bundle consumes verified-closure records as escalation and disablement inputs; production-excellence uses incident history as gate-entry evidence. - privacy-engineering (
../../privacy-engineering/SKILL.md) with product-lifecycle — Privacy engineering is shared. This bundle routes to it for trace scrubbing and user-data-access grants; product-lifecycle routes to it for PII, consent, retention, and data flows in any phase.
- production-readiness (
- Eval suite: evals/evals.json
neckbeard
- Derivation:
frontmatter-description-and-deferred-migration— source:bundles/neckbeard/SKILL.md - Purpose: Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request (issue, ticket, or request) from intake through planning, gates, implementation, review, verified PR, and authorized post-merge release. neckbeard routes the change through framing, discovery, design, implementation, review, verification, delivery, and learning — choosing the smallest safe intervention, proving it at the real delivery boundary, and leaving an inspectable evidence ledger. For change-request / issue-to-PR work, conditionally loads a 9-phase journey with gates, delivery packet, and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona, not a '10x developer' prompt, not a LOC-minimizer. The journey is not loaded for plain fixes, refactors, or reviews that lack an issue/ticket trajectory.
- Audience: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Stages: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Included skills: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Prerequisites: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Outputs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Handoffs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Conflicts: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Eval suite: migration deferred — see docs/bundle-manifest-design.md §Migration path
product-lifecycle
- Derivation:
manifest— source:bundles/product-lifecycle/manifest.yaml - Purpose: Route a product through its full lifecycle — discovery, strategy and portfolio choice, roadmap, UX and requirements, experimentation, delivery handoff, adoption, success, and lifecycle review — by composing existing specialist product skills with phase-entry evidence, handoff artifacts, and escalation rules.
- Audience: Product managers, product operations, and portfolio teams navigating a product across multiple lifecycle phases; agents that need to know which specialist skill to load at each phase and what evidence to hand off to the next phase.
- Stages (ordered):
- Discovery — product-discovery (
../../product-discovery/SKILL.md) - Strategy and portfolio choice — product-strategy (
../../product-strategy/SKILL.md), strategy-frameworks (../../strategy-frameworks/SKILL.md) - Roadmap — product-roadmapping-and-portfolio (
../../product-roadmapping-and-portfolio/SKILL.md) - UX and requirements — product-design-and-ux (
../../product-design-and-ux/SKILL.md) - Experimentation — product-experimentation (
../../product-experimentation/SKILL.md) - Delivery handoff — implementation-planning (
../../implementation-planning/SKILL.md), production-readiness (../../production-readiness/SKILL.md), release-engineering (../../release-engineering/SKILL.md) - Adoption — product-adoption (
../../product-adoption/SKILL.md) - Success — product-analytics-and-measurement (
../../product-analytics-and-measurement/SKILL.md), conditional-customer-success (../../conditional-customer-success/SKILL.md) - Lifecycle review — product-lifecycle-learning (
../../product-lifecycle-learning/SKILL.md)
- Discovery — product-discovery (
- Included skills:
- product-discovery (
../../product-discovery/SKILL.md) - product-strategy (
../../product-strategy/SKILL.md) - strategy-frameworks (
../../strategy-frameworks/SKILL.md) - product-roadmapping-and-portfolio (
../../product-roadmapping-and-portfolio/SKILL.md) - product-design-and-ux (
../../product-design-and-ux/SKILL.md) - product-experimentation (
../../product-experimentation/SKILL.md) - implementation-planning (
../../implementation-planning/SKILL.md) - production-readiness (
../../production-readiness/SKILL.md) - release-engineering (
../../release-engineering/SKILL.md) - product-adoption (
../../product-adoption/SKILL.md) - product-analytics-and-measurement (
../../product-analytics-and-measurement/SKILL.md) - conditional-customer-success (
../../conditional-customer-success/SKILL.md) - product-lifecycle-learning (
../../product-lifecycle-learning/SKILL.md) - product-methodology (
../../product-methodology/SKILL.md) - product-operations-and-governance (
../../product-operations-and-governance/SKILL.md) - financial-modeling (
../../financial-modeling/SKILL.md) - go-to-market (
../../go-to-market/SKILL.md) - data-scientist (
../../data-scientist/SKILL.md) - spec-driven-development (
../../spec-driven-development/SKILL.md) - privacy-engineering (
../../privacy-engineering/SKILL.md) - secure-software-engineering (
../../secure-software-engineering/SKILL.md) - verification-methodology (
../../verification-methodology/SKILL.md) - qa-methodology (
../../qa-methodology/SKILL.md) - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) - platform-engineering (
../../platform-engineering/SKILL.md) - neckbeard (
../../bundles/neckbeard/SKILL.md)
- product-discovery (
- Prerequisites:
- Product idea, market signal, or stakeholder request
- Problem statement and discovery log — via product-discovery (
../../product-discovery/SKILL.md) - Strategic assessment and portfolio decision — via product-strategy (
../../product-strategy/SKILL.md) - Roadmap entry and bet record — via product-roadmapping-and-portfolio (
../../product-roadmapping-and-portfolio/SKILL.md) - UX contracts and acceptance criteria — via product-design-and-ux (
../../product-design-and-ux/SKILL.md) - Experiment readout and assumptions register — via product-experimentation (
../../product-experimentation/SKILL.md)
- Outputs: lifecycle-evidence-ledger, problem-statement, strategic-assessment, roadmap-entry, interface-contracts, experiment-brief, implementation-plan, readiness-verdict, release-plan, adoption-plan, outcome-measurement, outcome-review, lifecycle-decision
- Handoffs:
- readiness-verdict → production-excellence bundle — Phase 6 delivery handoff routes the production-readiness verdict to the production-excellence launch gate when that bundle is available.
- implementation-plan → delivery team — Phase 6 hands the implementation plan and release plan to the delivery team (and neckbeard for SDLC change-request work).
- lifecycle-evidence-ledger → next phase (via evidence ledger) — Every phase reads and writes the shared lifecycle evidence ledger; the next phase never re-derives prior-phase evidence.
- lifecycle-decision → product-lifecycle-learning — Phase 9 records the continue/improve/harvest/pivot/pause/retire decision and retained learning in the learning loop.
- Conflicts:
- production-readiness (
../../production-readiness/SKILL.md) with production-excellence — Both bundles include production-readiness. Use production-excellence for launch-gate decisions; use product-lifecycle for phase 6 delivery handoff routing. Load the bundle matching the active decision context, never both at once. - production-readiness (
../../production-readiness/SKILL.md) with agent-production-operations — agent-production-operations consumes readiness outcomes as authority- gating inputs. Route phase 6 readiness reviews here; runtime authority decisions go to agent-production-operations. - release-engineering (
../../release-engineering/SKILL.md) with production-excellence — Release engineering is shared. Route by context: lifecycle delivery handoff (this bundle) versus gate-entry release evidence (production-excellence). - release-engineering (
../../release-engineering/SKILL.md) with agent-production-operations — Release engineering is shared. Route by context: lifecycle delivery handoff (this bundle) versus agent staged-rollout planning (agent-production-operations). - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with production-excellence — SRE is shared. This bundle routes to it for reliability needs in delivery handoff; production-excellence routes to it for gate-entry SLO/error-budget evidence. - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with agent-production-operations — SRE is shared. This bundle uses it for delivery reliability; agent-production-operations uses it for runtime latency/cost budgets and incident handoff. - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with production-excellence — Security engineering is shared. Route by phase/domain: trust-boundary work in lifecycle phases (this bundle) versus security evidence for launch gates (production-excellence). - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with agent-production-operations — Security engineering is shared. Route by context: lifecycle-phase security needs (this bundle) versus agent authority contracts and disablement security (agent-production-operations). - platform-engineering (
../../platform-engineering/SKILL.md) with production-excellence — Platform engineering is shared. Route by context: lifecycle delivery handoff (this bundle) versus gate-entry platform evidence (production-excellence). - platform-engineering (
../../platform-engineering/SKILL.md) with agent-production-operations — Platform engineering is shared. Route by context: lifecycle delivery handoff (this bundle) versus agent sandboxing and tool-execution isolation (agent-production-operations). - privacy-engineering (
../../privacy-engineering/SKILL.md) with agent-production-operations — Privacy engineering is shared. This bundle routes to it for PII, consent, retention, and data flows in any phase; agent-production-operations routes to it for trace scrubbing and user-data-access grants. - qa-methodology (
../../qa-methodology/SKILL.md) with production-excellence — QA methodology is shared. Route by context: lifecycle phase 6 quality gates (this bundle) versus launch verification evidence (production-excellence). - verification-methodology (
../../verification-methodology/SKILL.md) with production-excellence — Verification methodology is shared. This bundle uses it at every phase gate for evidence; production-excellence uses it for boundary labeling of launch evidence.
- production-readiness (
- Eval suite: evals/evals.json
production-excellence
- Derivation:
manifest— source:bundles/production-excellence/manifest.yaml - Purpose: Route cross-domain production evidence (readiness, migration, recovery, capacity/cost, incident-learning) into a launch or operational decision — go, no-go, defer, exception, or escalation — with an accountable owner and a post-launch learning path.
- Audience: Service owners, SRE, release, platform, security, data, and QA teams coordinating a production change; agents assembling cross-domain production evidence into a defensible launch decision without re-deriving specialist runbooks.
- Stages (ordered):
- Cross-domain evidence assembly — production-readiness (
../../production-readiness/SKILL.md), migration-engineering (../../migration-engineering/SKILL.md), resilience-and-recovery (../../resilience-and-recovery/SKILL.md), capacity-and-cost-engineering (../../capacity-and-cost-engineering/SKILL.md), incident-learning (../../incident-learning/SKILL.md) - Gate evaluation — production-readiness (
../../production-readiness/SKILL.md), site-reliability-engineering (../../site-reliability-engineering/SKILL.md), verification-methodology (../../verification-methodology/SKILL.md), qa-methodology (../../qa-methodology/SKILL.md) - Operational handoff — release-engineering (
../../release-engineering/SKILL.md), platform-engineering (../../platform-engineering/SKILL.md), secure-software-engineering (../../secure-software-engineering/SKILL.md), data-engineering (../../data-engineering/SKILL.md) - Post-launch learning — incident-learning (
../../incident-learning/SKILL.md)
- Cross-domain evidence assembly — production-readiness (
- Included skills:
- production-readiness (
../../production-readiness/SKILL.md) - migration-engineering (
../../migration-engineering/SKILL.md) - resilience-and-recovery (
../../resilience-and-recovery/SKILL.md) - capacity-and-cost-engineering (
../../capacity-and-cost-engineering/SKILL.md) - incident-learning (
../../incident-learning/SKILL.md) - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) - release-engineering (
../../release-engineering/SKILL.md) - platform-engineering (
../../platform-engineering/SKILL.md) - secure-software-engineering (
../../secure-software-engineering/SKILL.md) - data-engineering (
../../data-engineering/SKILL.md) - qa-methodology (
../../qa-methodology/SKILL.md) - verification-methodology (
../../verification-methodology/SKILL.md)
- production-readiness (
- Prerequisites:
- Readiness review evidence packet (risk-scaled, 11 categories) — via production-readiness (
../../production-readiness/SKILL.md) - Migration plan, compatibility windows, and reconciliation evidence — via migration-engineering (
../../migration-engineering/SKILL.md) - Resilience and recovery evidence (RTO/RPO, restore tests, game days) — via resilience-and-recovery (
../../resilience-and-recovery/SKILL.md) - Capacity and cost model evidence (demand, scaling, unit cost) — via capacity-and-cost-engineering (
../../capacity-and-cost-engineering/SKILL.md) - Incident history, causal hypotheses, and verified-closure records — via incident-learning (
../../incident-learning/SKILL.md) - SLO and error-budget status — via site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) - Release plan and rollback strategy — via release-engineering (
../../release-engineering/SKILL.md)
- Readiness review evidence packet (risk-scaled, 11 categories) — via production-readiness (
- Outputs: gate-decision, operational-handoff-record, accountable-owner-record, evidence-gap-register
- Handoffs:
- operational-handoff-record → incident-learning — Post-launch incidents (SLO degradations, unexpected failures, capacity breaches) route back to incident-learning with launch context; verified closure is required for follow-up items.
- operational-handoff-record → product-lifecycle-learning — Expected outcomes recorded in the handoff (SLO targets, capacity assumptions, cost projections) feed expected-vs-observed comparison at the handoff review cadence.
- gate-decision → agent-production-operations — Readiness outcomes (go/no-go/defer/exception) gate agent authority expansion when the runtime control plane is in use.
- accountable-owner-record → service owner — Every gate outcome names an accountable owner and records the evidence supporting it; no gate passes on a bare checklist.
- Conflicts:
- production-readiness (
../../production-readiness/SKILL.md) with product-lifecycle — Both bundles include production-readiness. This bundle owns the launch gate decision; product-lifecycle routes phase 6 delivery handoff. Load the bundle matching the active decision context, never both at once. - production-readiness (
../../production-readiness/SKILL.md) with agent-production-operations — agent-production-operations consumes readiness outcomes as authority- gating inputs. Readiness reviews and go/no-go/defer/exception outcomes are produced here and consumed there. - release-engineering (
../../release-engineering/SKILL.md) with product-lifecycle — Release engineering is shared. Route by context: gate-entry release evidence (this bundle) versus lifecycle delivery handoff (product-lifecycle). - release-engineering (
../../release-engineering/SKILL.md) with agent-production-operations — Release engineering is shared. Route by context: launch-gate release plans (this bundle) versus agent staged-rollout planning (agent-production-operations). - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with product-lifecycle — SRE is shared. This bundle routes to it for gate-entry SLO/error-budget evidence; product-lifecycle routes to it for delivery reliability. - site-reliability-engineering (
../../site-reliability-engineering/SKILL.md) with agent-production-operations — SRE is shared. This bundle uses it for gate-entry reliability evidence; agent-production-operations uses it for runtime latency/cost budgets and incident handoff. Incident command stays with SRE in both cases. - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with product-lifecycle — Security engineering is shared. Route by context: security evidence for launch gates (this bundle) versus trust-boundary work in lifecycle phases (product-lifecycle). - secure-software-engineering (
../../secure-software-engineering/SKILL.md) with agent-production-operations — Security engineering is shared. Route by context: launch-gate security evidence (this bundle) versus agent authority contracts and disablement security (agent-production-operations). - platform-engineering (
../../platform-engineering/SKILL.md) with product-lifecycle — Platform engineering is shared. Route by context: gate-entry platform evidence (this bundle) versus lifecycle delivery handoff (product-lifecycle). - platform-engineering (
../../platform-engineering/SKILL.md) with agent-production-operations — Platform engineering is shared. Route by context: launch-gate platform evidence (this bundle) versus agent sandboxing and tool-execution isolation (agent-production-operations). - incident-learning (
../../incident-learning/SKILL.md) with agent-production-operations — Both bundles consume incident-learning records. This bundle uses incident history as gate-entry evidence; agent-production-operations consumes verified-closure records as escalation and disablement inputs. - qa-methodology (
../../qa-methodology/SKILL.md) with product-lifecycle — QA methodology is shared. Route by context: launch verification evidence (this bundle) versus lifecycle phase 6 quality gates (product-lifecycle). - verification-methodology (
../../verification-methodology/SKILL.md) with product-lifecycle — Verification methodology is shared. This bundle uses it for boundary labeling of launch evidence; product-lifecycle uses it at every phase gate.
- production-readiness (
- Eval suite: evals/evals.json
research-and-vault
- Derivation:
frontmatter-description-and-deferred-migration— source:bundles/research-and-vault/SKILL.md - Purpose: Chain web research, atomic extraction, and durable knowledge capture into a repeatable workflow when the same research-to-notes sequence is needed.
- Audience: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Stages: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Included skills: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Prerequisites: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Outputs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Handoffs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Conflicts: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Eval suite: migration deferred — see docs/bundle-manifest-design.md §Migration path
tailscale
- Derivation:
frontmatter-description-and-deferred-migration— source:bundles/tailscale/SKILL.md - Purpose: Self-hosted Tailscale/Headscale ecosystem: deploy and manage a Headscale control server, configure tailscale clients, manage ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure.
- Audience: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Stages: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Included skills: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Prerequisites: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Outputs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Handoffs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Conflicts: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Eval suite: migration deferred — see docs/bundle-manifest-design.md §Migration path
workflow-architect
- Derivation:
frontmatter-description-and-deferred-migration— source:bundles/workflow-architect/SKILL.md - Purpose: Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure.
- Audience: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Stages: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Included skills: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Prerequisites: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Outputs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Handoffs: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Conflicts: migration deferred — see docs/bundle-manifest-design.md §Migration path
- Eval suite: migration deferred — see docs/bundle-manifest-design.md §Migration path