Rename fingerprint layers to intent and validate

[nahiyankhan]

Category: improvement
User Impact: Ghost now teaches and enforces the clearer intent.yml and validate.yml fingerprint vocabulary across packages, refs, docs, and agent handoffs.
Problem: The previous prose.yml and checks.yml names made the core model sound narrower than it is: intent is the portable product posture, while validation is a deterministic gate layer. Keeping the old names also made typed refs like prose.* and check:* less aligned with the package shape we want agents to read.
Solution: Rename the canonical split package layers and public schema vocabulary to intent.yml, validate.yml, intent.*, validate.check:*, and ghost.validate/v1. This is intentionally breaking and intentionally released as a minor while Ghost is pre-1.0.

Validation:

• pnpm typecheck: passed
• pnpm test: passed, 397 tests
• pnpm check: passed
• pre-commit hook: pnpm check passed, formatting check passed
• pre-push hook: pnpm build, pnpm test, and pnpm check passed
• node packages/ghost/dist/bin.js lint .ghost: passed, 0 issues
• node packages/ghost/dist/bin.js verify .ghost --root .: passed, 0 issues

Changeset: added minor changeset for @anarchitecture/ghost; this is a breaking pre-1.0 rename by design.

Ghost Review:

• node packages/ghost/dist/bin.js check --base origin/main: passed, 0 findings
• node packages/ghost/dist/bin.js review --base origin/main --max-diff-bytes 800000: generated full advisory packet, not truncated
• node packages/ghost/dist/bin.js review --base origin/main --include-memory: not supported by the current CLI; reran without the removed option

File changes

.changeset/fresh-falcons-validate.md
Adds the minor release note for the breaking pre-1.0 rename.

.ghost/fingerprint/composition.yml
Updates Ghost's own composition refs and wording to the new intent/validate vocabulary.

.ghost/fingerprint/intent.yml
Renames the dogfood intent layer from prose.yml and updates typed refs.

.ghost/fingerprint/inventory.yml
Updates dogfood exemplar refs and descriptions to use intent.*.

.ghost/fingerprint/validate.yml
Renames the dogfood validation layer from checks.yml and updates its schema.

CLAUDE.md
Updates repo-facing agent instructions for the new layer names and validation schema.

README.md
Updates public README shape, workflow, and command descriptions to use intent.yml and validate.yml.

apps/docs/src/app/page.tsx
Updates docs homepage language for the renamed core layers and deterministic gate file.

apps/docs/src/app/tools/scan/page.tsx
Updates scan tool UI copy for the new terminology.

apps/docs/src/content/docs/cli-reference.mdx
Updates CLI reference docs to the renamed files, refs, and schema.

apps/docs/src/content/docs/fingerprint-authoring.mdx
Updates authoring guidance for intent.yml and validate.yml.

apps/docs/src/content/docs/getting-started.mdx
Updates onboarding docs for the new package shape.

apps/docs/src/generated/cli-manifest.json
Regenerates CLI manifest text for the renamed help output.

docs/fingerprint-format.md
Updates the canonical format guide for intent.yml, validate.yml, and new typed refs.

docs/generation-loop.md
Updates generation loop instructions to read intent and validation layers.

docs/host-adapters.md
Updates adapter guidance for the renamed files.

docs/ideas/fingerprint-first-architecture.md
Updates architecture notes to the new model names.

docs/language-fingerprints.md
Updates language fingerprint examples and validation guidance.

install/install.sh
Updates installed bundle/file references for the renamed layer names.

packages/ghost-core/src/checks/index.ts
Renames exported check helpers to validation helpers.

packages/ghost-core/src/checks/lint.ts
Updates validation linting to expect intent derivation refs and ghost.validate/v1 documents.

packages/ghost-core/src/checks/routing.ts
Renames routing types/functions for validation checks.

packages/ghost-core/src/checks/schema.ts
Renames schema constants and derivation fields from prose/checks to intent/validate.

packages/ghost-core/src/checks/types.ts
Renames public check document and lint types to validation names.

packages/ghost-core/src/index.ts
Updates private core barrel exports for the renamed validation and intent APIs.

packages/ghost-core/src/map/schema.ts
Refreshes comments/terminology around legacy schema handling.

packages/ghost-core/src/types.ts
Updates shared type exports for the new validation naming.

packages/ghost-core/test/checks.test.ts
Updates private core validation tests for the new schema and refs.

packages/ghost-ui/.ghost/fingerprint/checks.yml
Removes the old Ghost UI validation filename.

packages/ghost-ui/.ghost/fingerprint/intent.yml
Renames Ghost UI's local intent layer from prose.yml.

packages/ghost-ui/.ghost/fingerprint/validate.yml
Adds the new Ghost UI validation layer.

packages/ghost-ui/README.md
Updates Ghost UI docs references to the renamed package files.

packages/ghost/src/cli.ts
Updates command descriptions for ghost.validate/v1.

packages/ghost/src/comparable-fingerprint.ts
Updates comparable fingerprint handling for intent field names.

packages/ghost/src/context/entrypoint-markdown.ts
Updates Relay Markdown labels from prose anchors to intent anchors.

packages/ghost/src/context/entrypoint.ts
Updates selected context structure, suggested reads, and action contracts for intent.

packages/ghost/src/context/graph.ts
Updates graph refs, source files, and check nodes to intent/validate refs.

packages/ghost/src/context/package-context.ts
Loads validate.yml and exposes intent layer raw content.

packages/ghost/src/context/package-review-command.ts
Updates emitted review command instructions and citations for the new layer names.

packages/ghost/src/core/check.ts
Runs deterministic gates from ghost.validate/v1 documents and validation routing.

packages/ghost/src/fingerprint-commands.ts
Updates lint/verify/scan command text and standalone validate lint behavior.

packages/ghost/src/fingerprint.ts
Updates public fingerprint package exports for the renamed paths.

packages/ghost/src/ghost-core/checks/index.ts
Updates bundled core check exports to validation names.

packages/ghost/src/ghost-core/checks/lint.ts
Updates bundled validation lint behavior and messages.

packages/ghost/src/ghost-core/checks/routing.ts
Renames bundled routing helpers to validation naming.

packages/ghost/src/ghost-core/checks/schema.ts
Updates bundled validation schema to ghost.validate/v1 and intent derivations.

packages/ghost/src/ghost-core/checks/types.ts
Updates bundled validation document and lint types.

packages/ghost/src/ghost-core/fingerprint-package.ts
Renames package filename constants to intent.yml and validate.yml.

packages/ghost/src/ghost-core/fingerprint/index.ts
Exports GhostFingerprintIntent* instead of prose schema/type names.

packages/ghost/src/ghost-core/fingerprint/lint.ts
Updates fingerprint lint refs, paths, and messages for intent and validate refs.

packages/ghost/src/ghost-core/fingerprint/schema.ts
Updates canonical fingerprint schema field and typed refs to intent / validate.check.

packages/ghost/src/ghost-core/fingerprint/types.ts
Updates canonical fingerprint document and ref types.

packages/ghost/src/ghost-core/index.ts
Updates public bundled core exports for the renamed APIs.

packages/ghost/src/ghost-core/map/schema.ts
Refreshes terminology comments for intent wording.

packages/ghost/src/ghost-core/types.ts
Updates bundled shared exports for validation naming.

packages/ghost/src/init-command.ts
Makes ghost init report/write intent.yml and validate.yml.

packages/ghost/src/monorepo-init-command.ts
Updates monorepo init output/path handling for renamed files.

packages/ghost/src/relay.ts
Updates Relay option help to mention intent.yml.

packages/ghost/src/review-packet.ts
Updates advisory packet instructions and citations for intent/validate files.

packages/ghost/src/scan-stack-command.ts
Updates stack summaries to read intent product/entries and validation checks.

packages/ghost/src/scan/body.ts
Refreshes direct fingerprint parser language around intent/prose wording.

packages/ghost/src/scan/constants.ts
Renames canonical scan constants to intent.yml and validate.yml.

packages/ghost/src/scan/file-kind.ts
Detects and lints intent.yml / validate.yml files.

packages/ghost/src/scan/fingerprint-package-layers.ts
Loads, assembles, lints, and templates the new split layer names.

packages/ghost/src/scan/fingerprint-package.ts
Resolves package paths, init files, and package linting for intent/validate.

packages/ghost/src/scan/fingerprint-stack.ts
Merges stacks using the new intent and validation document fields.

packages/ghost/src/scan/frontmatter.ts
Refreshes parser comments/messages around intent wording.

packages/ghost/src/scan/lint.ts
Updates lint terminology and soft validation ref text.

packages/ghost/src/scan/parser.ts
Refreshes parser comments for direct fingerprint intent/prose semantics.

packages/ghost/src/scan/scan-status.ts
Reports readiness counts and states using intent instead of prose.

packages/ghost/src/scan/schema.ts
Refreshes schema comments around narrative intent fields.

packages/ghost/src/scan/verify-fingerprint.ts
Updates verification text for validate.yml.

packages/ghost/src/scan/verify-package.ts
Verifies evidence and check refs using intent paths and validation docs.

packages/ghost/src/scan/writer.ts
Writes split fingerprint output using the new intent layer name.

packages/ghost/src/skill-bundle/SKILL.md
Updates installed Ghost skill instructions for intent.yml and validate.yml.

packages/ghost/src/skill-bundle/references/authoring-scenarios.md
Updates authoring scenario guidance to use intent layer terminology.

packages/ghost/src/skill-bundle/references/brief.md
Updates briefing recipe reads for the renamed files.

packages/ghost/src/skill-bundle/references/capture.md
Updates capture workflow, file tree, and validation examples.

packages/ghost/src/skill-bundle/references/critique.md
Updates critique guidance to cite intent/validate artifacts.

packages/ghost/src/skill-bundle/references/patterns.md
Updates pattern guidance and check ref examples.

packages/ghost/src/skill-bundle/references/recall.md
Updates recall recipe reads for intent.yml.

packages/ghost/src/skill-bundle/references/review.md
Updates review recipe and blocking check language for validate.yml.

packages/ghost/src/skill-bundle/references/schema.md
Updates schema reference for file names, refs, and validation schema.

packages/ghost/src/skill-bundle/references/voice.md
Updates language/voice examples for intent and validation refs.

packages/ghost/test/checks-grounding.test.ts
Updates validation grounding tests to new refs and schema.

packages/ghost/test/cli.test.ts
Updates CLI tests for init, lint, scan, relay, check, and stack outputs.

packages/ghost/test/context-entrypoint.test.ts
Updates Relay/context graph expectations for intent and validation refs.

packages/ghost/test/fingerprint-package.test.ts
Updates split package loading/lint tests for intent.yml.

packages/ghost/test/fingerprint-stack.test.ts
Updates stack merge tests for intent and validate documents.

packages/ghost/test/fingerprint-yml-schema.test.ts
Updates canonical schema tests for the intent field and validate.check refs.

packages/ghost/test/fixtures/context-sandboxes/harness.ts
Updates context sandbox fixture generation for intent and validate files.

packages/ghost/test/relay.test.ts
Updates Relay test expectations for renamed context.

packages/ghost/test/scan-status.test.ts
Updates scan readiness tests for intent counts/states.

Screenshots/Demos: N/A; this is CLI/schema/docs/fingerprint vocabulary work rather than a visual surface change.