{
  "schema": "agent-buildprint/v2",
  "slug": "buildprint-mapper-os",
  "title": "Buildprint Mapper OS",
  "canonicalStart": "BUILDPRINT.md",
  "tier": "agent-grade",
  "mode": "agent-run-mapper-workflow",
  "bindingSlice": [
    "source acquisition with read-only boundary",
    "safe census with CENSUS_HINT-only authority",
    "source-surface census with high-signal disposition tracking",
    "behavior discovery with source evidence promotion",
    "scope selection before selected extraction",
    "source-independent executable-blueprint distillation",
    "selected-buildprint executable Buildprint shape",
    "downstream-agent execution planning",
    "qualification gates and no-fake blockers",
    "handoff without source dependency"
  ],
  "files": [
    {
      "path": "acceptance.yaml",
      "role": "source"
    },
    {
      "path": "buildprint.json",
      "role": "source"
    },
    {
      "path": "BUILDPRINT.md",
      "role": "source"
    },
    {
      "path": "checks/acceptance.md",
      "role": "source"
    },
    {
      "path": "claims.yaml",
      "role": "source"
    },
    {
      "path": "CONTRACTS.md",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/.env.example",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/app/admin/users/page.tsx",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/app/api/admin/users/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/src/models/db.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/src/routes/auth/session.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/admin-dashboard/tests/admin-auth.test.js",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/.github/workflows/ci.yml",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/apps/web/src/app/admin/page.tsx",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/apps/web/src/app/api/admin/users/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/apps/web/src/app/api/billing/webhook/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/packages/worker/src/content-agent.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/large-monorepo/prisma/schema.prisma",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/.env.example",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/prisma/schema.prisma",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/README.md",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/app/api/chat/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/app/api/documents/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/lib/memory/index.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/lib/ollama-provider.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/lib/rag/context.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/local-rag-chat/src/lib/rag/ingest.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/malicious-secrets/.env.example",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/malicious-secrets/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/malicious-secrets/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/malicious-secrets/README.md",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/malicious-secrets/src/agent.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/.env.example",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/app/(auth)/login/page.tsx",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/app/(chat)/api/chat/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/route-patterns/src/routes/api/tasks/index.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/expected-signals.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/package.json",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/src/app/api/billing/checkout/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/src/app/api/stripe/webhook/route.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/src/lib/stripe.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/src/models/subscription.ts",
      "role": "source"
    },
    {
      "path": "evals/golden-projects/stripe-saas/tests/billing.test.js",
      "role": "source"
    },
    {
      "path": "evals/README.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/01-questions.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/02-project-setup.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/03-phases/01-ingest-record.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/03-phases/phase-flow.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/03-phases/phase-index.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/04-evaluation.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/05-evidence/evidence-ledger.jsonl",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/05-evidence/evidence-ledger.schema.json",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/data-persistence.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/integration-runtime.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/product-architect.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/security-boundary.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/test-and-verification.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/06-contracts/ux-ui-craft.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/blueprint.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/BUILDPRINT.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/executable-packet-good/selected-buildprint/generated/agent-prompt.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/01-questions.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/02-project-setup.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/03-phases/01-ingest-record.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/03-phases/phase-flow.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/03-phases/phase-index.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/04-evaluation.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/05-evidence/evidence-ledger.jsonl",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/05-evidence/evidence-ledger.schema.json",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/data-persistence.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/integration-runtime.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/product-architect.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/security-boundary.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/test-and-verification.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/06-contracts/ux-ui-craft.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/blueprint.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/BUILDPRINT.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/phase-flow-no-subagent-fallback/selected-buildprint/generated/agent-prompt.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/01-questions.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/02-project-setup.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/03-phases/01-ingest-record.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/03-phases/phase-flow.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/03-phases/phase-index.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/04-evaluation.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/05-evidence/evidence-ledger.jsonl",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/05-evidence/evidence-ledger.schema.json",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/data-persistence.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/integration-runtime.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/product-architect.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/security-boundary.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/test-and-verification.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/06-contracts/ux-ui-craft.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/blueprint.yaml",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/BUILDPRINT.md",
      "role": "source"
    },
    {
      "path": "evals/selected-output-fixtures/unknown-requires-role/selected-buildprint/generated/agent-prompt.md",
      "role": "source"
    },
    {
      "path": "HOW_TO_EVAL.md",
      "role": "source"
    },
    {
      "path": "METHODOLOGY.md",
      "role": "source"
    },
    {
      "path": "phases.yaml",
      "role": "source"
    },
    {
      "path": "PLAN.md",
      "role": "source"
    },
    {
      "path": "plans/00-safety-boundaries.md",
      "role": "source"
    },
    {
      "path": "plans/01-repo-census.md",
      "role": "source"
    },
    {
      "path": "plans/02-system-map.md",
      "role": "source"
    },
    {
      "path": "plans/03-candidate-buildprints.md",
      "role": "source"
    },
    {
      "path": "plans/04-scope-decision.md",
      "role": "source"
    },
    {
      "path": "plans/05-single-extraction.md",
      "role": "source"
    },
    {
      "path": "plans/06-system-extraction.md",
      "role": "source"
    },
    {
      "path": "plans/07-validation-submission.md",
      "role": "source"
    },
    {
      "path": "policies/quality.md",
      "role": "source"
    },
    {
      "path": "policies/questions.md",
      "role": "source"
    },
    {
      "path": "policies/safety.md",
      "role": "source"
    },
    {
      "path": "prompts/discover.md",
      "role": "source"
    },
    {
      "path": "prompts/extract-selected.md",
      "role": "source"
    },
    {
      "path": "questions.md",
      "role": "source"
    },
    {
      "path": "README.md",
      "role": "source"
    },
    {
      "path": "schemas/candidate.schema.json",
      "role": "source"
    },
    {
      "path": "SPEC.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/01-questions.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/02-project-setup.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/03-phases/01-example-phase.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/03-phases/phase-flow.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/03-phases/phase-index.yaml",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/04-evaluation.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/05-evidence/evidence-ledger.jsonl",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/05-evidence/evidence-ledger.schema.json",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/blueprint.yaml",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/BUILDPRINT.md",
      "role": "source"
    },
    {
      "path": "templates/executable-packet/generated/agent-prompt.md",
      "role": "source"
    },
    {
      "path": "templates/teams/data-persistence.md",
      "role": "source"
    },
    {
      "path": "templates/teams/integration-runtime.md",
      "role": "source"
    },
    {
      "path": "templates/teams/product-architect.md",
      "role": "source"
    },
    {
      "path": "templates/teams/security-boundary.md",
      "role": "source"
    },
    {
      "path": "templates/teams/test-and-verification.md",
      "role": "source"
    },
    {
      "path": "templates/teams/ux-ui-craft.md",
      "role": "source"
    },
    {
      "path": "VERIFICATION.md",
      "role": "source"
    },
    {
      "path": "vision.md",
      "role": "source"
    }
  ],
  "forbiddenDefaults": [
    "agb map CLI entrypoint",
    "long pre-discovery questionnaire",
    "source app mutation during mapping",
    "secret value copying",
    "scanner-authored product facts",
    "selected extraction without scope decision",
    "root implementation scaffold",
    "obsolete selected-output template spine",
    "one giant execution file for medium/large/full-suite scopes",
    "mocks or fixtures counted as product implementation",
    "validation or parity claims without evidence",
    "route/function parity as a selected-output requirement",
    "high-signal source surfaces disappearing without disposition",
    "selected-output router drift",
    "typo alias files such as VERFICATION.md, IMPLEMENATION.md, or CAPABILTY_INDEX.md",
    "duplicate canonical handoff files such as both HANDOFF.md and HANDOVER.md",
    "downstream agent required to read all markdown files before first action",
    "obsolete selected-output files: CAPABILITY_INDEX.md, CONTEXT_PACKET.json, TEAM_STACK.md, UX_CONTRACT.md, DESIGN_QUALITY_BAR.md, CURRENT_STATE.md, EXECUTION_PROTOCOL.md, IMPLEMENTATION_PLAN.md, manifest.json, 02-context/active-slice.yaml, 07-execution/phases/, capabilities/, generated/current-buildprint-compat/",
    "obsolete default selected files: AGENT_EXECUTION_BRIEF.md, agent-contract.xml, TEST_MATRIX.md, TRACEABILITY_MATRIX.md, IMPLEMENTATION_COMPLETENESS.md",
    "fragmented per-capability mini-files such as capability.yaml, source-evidence.md, product-contract.md, implementation-workflow.md, or proof-contract.yaml"
  ],
  "authoritySpine": "BUILDPRINT.md",
  "mirrorFiles": [
    "buildprint.json",
    "phases.yaml",
    "acceptance.yaml",
    "claims.yaml"
  ],
  "requiredDetailFiles": [
    "VERIFICATION.md",
    "questions.md",
    "policies/safety.md",
    "policies/quality.md",
    "policies/questions.md",
    "prompts/discover.md",
    "prompts/extract-selected.md",
    "checks/acceptance.md"
  ],
  "requiredChecks": [
    "npm run check:mapper-output",
    "npm run check:mapper-output:negative",
    "npm run check:spine"
  ],
  "schemaVersion": "mapper-os/executable-blueprint",
  "keywords": []
}