petrova.codes

petrova.codes

Pull by slug. Pin by version.

Skills · 11

SKILL
v0.1.0 2026-05-08

petrova-act

Use when performing a Petrova control-plane action against a registered repo - opening a decision doc, adding/updating/deferring a milestone, opening or closing a phase, recording a verification round

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-act/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-boundary-check

Use to audit capability boundaries — every place this repo has scripts, agents, or CI workflows writing to sensitive surfaces (.github/workflows/, *.env, secrets/, deploy/credentials/, IAM, the databa

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-boundary-check/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-decide

Use when recording any non-trivial architectural call, scope change, supersession, or decision-shaped event in PETROVA-format — date-stamped, append-only, ≥2 alternatives considered, sign-off block re

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-decide/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-drift-check

Use to detect drift — between this repo and PETROVA's shared methodology, between this repo's CLAUDE.md and its actual code, between recent commits and the north-star intent. Produces a numbered drift

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-drift-check/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-mr-audit

Use to audit any repo against MR-1 through MR-12 — the cross-cutting invariants. Read-only; never modifies files. Produces a single PASS/WARN/FAIL table with per-rule evidence (one file:line citation

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-mr-audit/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-onboard

Use when admitting a new repository to the PETROVA control plane — composing the registry-update PR, deriving the right role/profile/fleets_allowed, and (optionally) bootstrapping the consumer with co

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-onboard/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-phase-cycle

Use at every phase boundary — runs the mandatory verification round (MR-10), classifies surfaced friction (closed / in-budget / deferred per MR-2), composes phase-N-close.md with human countersign, th

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-phase-cycle/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-plan

Use to plan any feature, refactor, or non-trivial change with PETROVA discipline — taskset-shaped sequencing, halt-for-confirmation gates, MR-grounded rationale, explicit reuse-before-build, drift-ris

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-plan/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-realign

Use when this repo's work has drifted from its north-star intent — recent commits land features outside scope, the backlog has eaten the focus, or load-bearing infrastructure is being neglected for su

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-realign/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-recover

Use when a verb returned failed, --apply errored, or something unexpected happened during a PETROVA operation. Maps the error code to the canonical recovery playbook, prescribes the recovery path adap

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-recover/SKILL.md
SKILL
v0.1.0 2026-05-08

petrova-status

Use when the user wants a read-only view of Petrova-line repos - cross-repo status dashboard ("what's open across my projects?"), single-repo diagnose ("what's the state of kahn-hq?"), or MR/conventio

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/skills/petrova-status/SKILL.md

Prompts · 11

PROMPT
v0.1.0 2026-05-08

ARES wire-up — turn a consumer repo's CI into ARES dashboard rows

> **What this is.** A single prompt that walks Claude Code through wiring one repo's CI/CD observability signal to ARES (`cicd.devarno.cloud`). Pas...

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/06-ares-wire.md
PROMPT
v0.1.0 2026-05-08

Bootstrap prompt — paste into Claude Code on day 1

> **What this is.** A single prompt that turns a bare-bones scaffolded repo

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/00-bootstrap.md
PROMPT
v0.1.0 2026-05-08

CRUMB wire-up — turn a consumer repo's guidance docs into validated CRUMB flashcards

> **What this is.** A single prompt that walks Claude Code through wiring one repo's guidance docs to CRUMB: author N flashcards as markdown under ...

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/08-crumb-wire.md
PROMPT
v0.1.0 2026-04-28

Drift-check prompt

> Paste when something feels off — a PR that doesn't quite serve the

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/04-drift-check.md
PROMPT
v0.1.0 2026-05-08

EVA wire-up — register a consumer repo against the three EVA surfaces

<!--

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/10-eva-wire.md
PROMPT
v0.1.0 2026-05-08

LORE + CAIRNET wire-up — register a consumer repo with Pebble's knowledge collection and agent emission stream

<!--

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/09-rocky-wire.md
PROMPT
v0.1.0 2026-05-08

Onboarding prompt — register a repo in the petrova line

> **What this is.** A single prompt that walks Claude Code through admitting

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/05-petrova-onboard.md
PROMPT
v0.1.0 2026-04-28

Phase-close prompt

> Paste when a phase has met its acceptance gates and is ready to close.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/02-phase-close.md
PROMPT
v0.1.0 2026-04-28

Phase-open prompt

> Paste at the start of each phase. The agent verifies entry criteria,

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/01-phase-open.md
PROMPT
v0.1.0 2026-05-08

Traceo + Ariel wire-up — turn a consumer repo's spec layer into a validated VTM with mermaid + an Ariel baseline

> **What this is.** A single prompt that walks Claude Code through wiring one repo's spec/architecture surface to Traceo + Ariel: register a baseli...

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/07-traceo-wire.md
PROMPT
v0.1.0 2026-04-28

Verification round prompt

> Invoked from `prompts/02-phase-close.md` (or standalone if the human

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/core/prompts/03-verification-round.md

Schemas · 13

SCHEMA
v0.1.0 2026-04-29

close_phase

Close an open phase. Requires a paired verification_round decision doc and explicit friction classification for every surfaced item. Marks the phase's decision doc status=closed via supersession-style edit (only permitted edit to a closed-side doc per MR-7 is adding the back-reference).

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/close_phase.schema.json
SCHEMA
v0.1.0 2026-05-13

declare_baseline

Ratify a new petrova baseline version (v2, v3, …) as a decision doc in petrova-codes. The verb's pre-flight runs the full server-side audit and refuses to proceed if any MR check is `fail` — declaration is a real verification, not a paper claim. Emits `docs/decisions/<date>-petrova-baseline-v<N>.md` populated from the operator-supplied scope + roster.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/declare_baseline.schema.json
SCHEMA
v0.1.0 2026-04-29

diagnose

Read-only collection of cross-cutting context across a target repo: current phase, open milestones, recent decisions, recent findings, failing CI checks. Returns a structured report consumable by other verbs (notably propose_fix) or by humans/agents directly.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/diagnose.schema.json
SCHEMA
v0.1.0 2026-04-29

open_decision

Open a new dated decision doc in the target repo's docs/decisions/. Creates a PR adding a single file conforming to the repo's decision-doc template. The doc is opened in 'open' status with sign-off block awaiting human countersign.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/open_decision.schema.json
SCHEMA
v0.1.0 2026-05-13

petrova_install_playbook

Deposit the petrova playbook (META-RULES.md, 00-bootstrap.md, mr-preamble.xml, progress-signal.xml, airlock-rules.xml, progress.schema.json) into a consumer repo's `.petrova/playbook/` directory. Cross-references remain Fleet-MCP fetch directives (petrova.prompts.get <slug>); they are NOT rewritten to local filesystem paths (consumers carry only .petrova/playbook/). This is Step 0 of the bare-bones-to-baselined journey; petrova_onboard depends on it for path resolution.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/petrova_install_playbook.schema.json
SCHEMA
v0.1.0 2026-05-13

petrova_onboard

Initialise a registered repo's mechanical petrova floor: write `.petrova/contract.yaml` with default integration declarations + install `.github/workflows/docs-invariants.yml` if missing. Narrow compliance verb — does NOT generate CLAUDE.md / MILESTONES.md / AGENTS.xml / north-star (those stay prose-driven via `00-bootstrap.md`). The verb's job is to make the mechanical floor harder to skip.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/petrova_onboard.schema.json
SCHEMA
v0.1.0 2026-04-29

propose_fix

Draft a fix PR grounded in a preceding diagnose run. Composes request_review under the hood, but adds a hard binding to a diagnosis_id and requires explicit MR-12 grounding for the proposed change. The verb fleets reach for when implementing fixes.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/propose_fix.schema.json
SCHEMA
v0.1.0 2026-04-29

request_merge_when_green

Open a PR (same surface as request_review) AND mark it for auto-merge once branch protection / CI gates pass. Profile-restricted: only permitted on registry profile=permissive, or profile=standard with explicit fleet allow. Never permitted on profile=strict — those repos require human merge.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/request_merge_when_green.schema.json
SCHEMA
v0.1.0 2026-04-29

request_review

Generic write surface: open a PR with arbitrary file changes and request review. The lower-level primitive other write verbs may compose. Does NOT mark auto-merge — human approval gates the merge.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/request_review.schema.json
SCHEMA
v0.1.0 2026-04-29

start_phase

Open a new phase. Composes open_decision (writes phase-N-open.md) plus update_milestone seeding for declared sub-milestones. Predecessor phase must be closed.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/start_phase.schema.json
SCHEMA
v0.1.0 2026-04-29

update_milestone

Add a new milestone or transition an existing one in the target repo's MILESTONES.md. State transitions are restricted: planned → active → complete | deferred | retired. Marking complete requires evidence_path resolving to docs/verification/.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/update_milestone.schema.json
SCHEMA
v0.1.0 2026-04-29

verify_round

Record the output of a phase-close verification round. Creates a dated decision doc capturing surfaced items prior to classification (close_phase consumes this doc and applies the classifications). Mandatory at every phase close per MR-10, even when no friction surfaces.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/verify_round.schema.json
SCHEMA
v0.1.0 2026-05-13

wire_integration

Flip a registered consumer repo's `.petrova/contract.yaml` integration block from `pending` (or `failing`) to `wired`, with a validated evidence object. Generic over integration: ARES, TRACEO, CRUMB, ROCKY, EVA. The evidence schema is enforced per integration (mirrors contracts/contract.schema.json's integration_<name> sub-schemas). Refuses to wire an integration that is already `wired` (use a new verb for re-wiring or evidence updates). Requires a ratifying decision doc at the cited path; that ADR is the human accountability anchor.

curl -fsSL https://raw.githubusercontent.com/petrova-codes/petrova/main/spec/verbs/wire_integration.schema.json