Docs map

Full index for the Skill Steward documentation site and repo. Use this as the canonical-owner map before editing docs.

Quick router

I want to...	Canonical owner	Go to
Understand charter and scope	Charter	North Star
Adopt stewardship in any repo	Repo quality spec	Repo quality contracts
Check current dogfood/adopter status	Current ledger	Current dogfood status
Audit public dogfood reproducibility	Public proof card	Current dogfood reproducibility
Use the first adopter reference path	Reference fixture, not proof	First adopter golden path
Record an adoption run	Template/reference, not proof	Adoption run v2 template
Record a pattern promotion decision	Historical example	Pattern promotion review: generational lens
Create or classify evidence	Concept layer	Evidence artifacts
Inspect historical proof packets	Evidence archive	Use the docs sidebar archive; historical packets are provenance unless the current ledger says they still hold.
Decide whether to split, compress, promote, demote, delete, or stay native	Concept layer	Evolutionary simplicity
Decide whether to add code, generate, harness, document, or delete	Architecture application	Generational architecture ladder
Install or update skills	Operational how-to	DX_FAQ
Add or review Agent Skills	Skill package spec	STANDARDS
Understand why the repo is shaped this way	Rationale	DESIGN_FAQ · Decisions
Choose which FAQ/doc to edit	Docs lattice	Doc lattice
Understand stewardship concepts	Concept layer	Stewardship loop · Evidence ladder · Evidence artifacts
Choose the correct steward invocation	Concept layer	Portable Steward invocation
Plan hygiene (extract & remove)	Workflow doctrine	Plan hygiene
Skill/plugin marketplaces	Distribution skill	Skill plugin-marketplace-setup · ADR 0004
Local harness/action contract adoption	Harness skill	Skill mcp-harness-repo-maintainer · ADR 0017
Cross-repo harness generalization	Harness lifecycle	Skill harness-engineering-lifecycle · ADR 0006
Steward contract schemas	Schema reference	Schemas
Visual brand identity	Brand reference	Brand · ADR 0012
Agent entry map	Agent workspace map	AGENTS.md
Enable / preview docs.page	Docs publishing	Enable docs.page

Executable truth

Docs should point here instead of paraphrasing behavior.

Behavior	Executable owner	Notes
Maintainer commands	package.json	Script names are the command SSOT; DX_FAQ explains usage.
Steward CLI behavior	packages/steward_cli/	Dart code is the runtime truth for validate/eval/list/contract commands.
Repo-local contract	steward.yaml	Declares repo archetype, stewardship pillars, evidence policy, and, when harness-enabled, local actions/probes.
Portable data shapes	docs/schemas/*.json	JSON Schema covers shape; Dart validators enforce cross-field and repo-state rules.
T1 behavior-critical skill routing	packages/steward_cli/lib/src/eval/eval_tiers.dart + skills/*/evals/cases/*.yaml	T-named gate list and case files are the CI gate.
Skill/package validation	packages/steward_cli/lib/src/validation/	docs/STANDARDS.mdx explains the contract; validators enforce it.
Benchmark scenarios	steward/scenarios/	Durable execution proof is blocked unless contract inputs are clean and tracked.
Current evidence ledger	docs/evidence/current-dogfood-status.mdx	Current weakest true dogfood/adopter claims, blockers, and rerun routes.
Public dogfood reproducibility	docs/evidence/current-dogfood-reproducibility.mdx	Public/auditable subset of current dogfood proof; local diary context stays in the current ledger.
First adopter reference fixture	docs/evidence/first-adopter-golden-path.mdx	Sanitized baseline and harness smoke path; not proof from a live adopter run.
Historical runtime text-input packet	docs/evidence/mcp-flutter-runtime-text-input-capability-proof-2026-06-10.mdx	Historical mcp_flutter recipe; current claim and source-checkout blocker live in the current ledger.
H4 workflow check	docs/evidence/h4-fresh-agent-workflow-check-2026-06-08.mdx	Historical blocked H4/H2 evidence and product lesson.
CI/release gates	.github/workflows/	Workflow files define what remote automation actually runs.

Published site (docs/)

• Overview
• North Star
• Repo quality contracts
• Skills Catalog
• Current dogfood status
• Current dogfood reproducibility
• First adopter golden path
• Plan hygiene (extract & remove)
• Schemas
• Brand identity
• Enable docs.page
• STANDARDS
• Decisions
• Evolutionary simplicity
• Generational architecture ladder
• Evidence artifacts

Concept layer

Concept	Use for
Stewardship loop	How friction becomes durable repo knowledge or tooling
Distribution boundaries	How mission differs from skills, CLI, plugins, and product harnesses
Portable Steward invocation	Released binary, Dart source, local activation, and local-provenance command rules
Evolutionary simplicity	Parent pattern for splitting, compressing, promoting, demoting, deleting, or staying native
Evidence ladder	What proof is required before making quality or readiness claims
Evidence artifacts	When proof notes, blocked states, ledgers, and templates deserve durable evidence status
Doc lattice	Which docs own charter, why, how, specs, maps, behavior, and procedures
Generational architecture ladder	Architecture application of evolutionary simplicity: when to keep native code, extract patterns, generate, add harness proof, or delete

Repo root (GitHub)

File	Role
README.md	Landing page, adoption summary, shortest install path
docs/DESIGN_FAQ.mdx	Why (compressed)
docs/DX_FAQ.mdx	How (commands and contributor workflow)
docs/STANDARDS.mdx	Agent Skills package spec
docs/repo-quality-contracts.mdx	General repo quality contract spec
docs/evidence/	Claim-proof records, current ledgers, blocked-state evidence, and historical provenance; templates and reference fixtures there are not proof
AGENTS.md	Agent map (~100 lines)
docs/brand.mdx	Visual identity reference
skills/	Installable packages
plugins/	Hook/wiring bundles
docs.json	docs.page config

Skills catalog

Browsable on the docs site: Skills Catalog. Registry groupings: skills.sh.json.