Onboarding

Petrova

24 cards ~ 2.2 h Foundational

Foundational walk through the petrova project. Read top to bottom if you're new; no prior context assumed.

  1. petrova intermediate 5 min

    Playbook Repo as Control-Loop Distribution

    Use when: deciding whether content belongs in petrova-hq or a consumer repo; explaining why petrova-hq has no app code or test runner; tracing how a methodology change reaches every governed repo

  2. petrova intermediate 4 min

    Submodule Topology: prompts + templates

    Use when: editing a prompt or template and seeing 'modified content' in petrova-hq; deciding whether to commit in the parent or in a submodule; rolling out a methodology change to consumers via pointer bump

  3. petrova advanced 12 min

    Meta-Rules MR-1..MR-15 Invariants

    Use when: auditing a repo for governance compliance; deciding whether a proposed change violates a cross-cutting rule; writing a refusal_condition for a new subagent

  4. petrova intermediate 6 min

    Acceptance-Gated Phase Lifecycle

    Use when: deciding whether a phase is ready to close; reading a MILESTONES.md status block; explaining why open / next / closed are the only valid transitions

  5. petrova intermediate 6 min

    Bootstrap Prompt Q1-Q7 Calibration

    Use when: running 00-bootstrap.md against a fresh consumer repo; auditing why a generated CLAUDE.md contains a particular invariant; explaining why MR-15 makes Q1-Q7 schema-bound

  6. petrova intermediate 7 min

    Phase-Open / Phase-Close Prompt Pair

    Use when: starting or ending a phase via Claude Code; writing a phase-open or phase-close decision doc by hand; explaining why phase prompts are deliberately interactive

  7. petrova intermediate 6 min

    Verification Rounds at Phase Close

    Use when: running 03-verification-round.md inline at phase close; deciding which probe shape (A-F) applies to the phase being closed; explaining why zero findings is a failure mode

  8. petrova intermediate 5 min

    Drift Check Cadence and Verdict

    Use when: a PR feels off but you cannot articulate why; a doc just landed that contradicts another; deciding whether a change is scope creep or a real new milestone

  9. petrova intermediate 5 min

    Decision Docs Append-Only with Supersession

    Use when: revising a closed verdict; writing a decision doc that overturns an earlier one; auditing a repo for MR-7 compliance

  10. petrova advanced 8 min

    Outranks DAG and docs-invariants CI

    Use when: adding a new doc category to a consumer repo; debugging a docs-invariants CI failure; auditing whether the rank-graph DAG still holds

  11. petrova advanced 9 min

    AGENTS.xml Subagent Fleet

    Use when: adding a new subagent role; wiring spawns_on triggers for an existing role; explaining MR-6 (read AGENTS.xml, never improvise delegation)

  12. petrova intermediate 7 min

    Fleet State Registry — state/ + registry.yaml

    Use when: reading or editing a per-repo state file; explaining why probes auto-demote but never auto-promote; auditing the difference between intent (contract) and observation (state)

  13. petrova intermediate 6 min

    Fleet-Snapshot Workflow to CASA Dashboard

    Use when: debugging why the CASA Petrova zone is stale; rotating HUBBLE_INGEST_TOKEN; explaining the daily 07:00 UTC snapshot path

  14. petrova intermediate 9 min

    Integration Wire Prompts: ARES, Traceo, CRUMB, Rocky, Eva

    Use when: wiring a consumer repo to one of the five integration surfaces; deciding which prompt to paste for an integration mission; auditing whether a wire-up adheres to the gated-taskset discipline

  15. petrova intermediate 8 min

    Petrova Skills Set

    Use when: choosing the right petrova-* skill for an operator question; auditing why a write skill refused to proceed; mapping a verb invocation back to its containing skill

  16. petrova beginner 3 min

    The Agent-Powered Repo Playbook

    Use when: writing the petrova homepage hero; explaining petrova to a founder shipping with Claude Code

  17. petrova beginner 3 min

    Who Petrova Is For

    Use when: qualifying inbound interest; deciding whether a project is ready to adopt petrova

  18. petrova beginner 2 min

    The Pitch in One Screen

    Use when: writing the homepage hero or a tweet; pitching petrova to another developer in under a minute

  19. petrova beginner 4 min

    From Bootstrap to 31 Repos

    Use when: telling the story of how petrova got here; explaining what shipped this phase and what's next

  20. petrova beginner 4 min

    Why Not a Monorepo Tool

    Use when: responding to 'isn't this just Nx or Turborepo?'; comparing petrova against hand-rolled scripts or a wiki

  21. petrova beginner 3 min

    Multi-repo orgs need a shared brain for AI agents

    Use when: framing why repo-level agent context is a venture-shaped category; answering 'why now' for AI-agent orchestration in software organizations

  22. petrova beginner 3 min

    The buyer is the org running ten or more services

    Use when: sizing the addressable market for repo-level AI-agent tooling; answering 'who pays for this' in a partner conversation

  23. petrova beginner 4 min

    The moat is the dated paper trail, not the prompts

    Use when: answering 'what stops Cursor or GitHub from building this in a weekend'; explaining why the defensibility lives in the discipline, not the file format

  24. petrova beginner 3 min

    Sole author, 31 repos, dated receipts

    Use when: answering 'who is building this' in a first-meeting; framing solo-builder velocity as evidence, not a risk