{ "$schema": "../../schemas/manifests/package-surface.schema.json", "installModel": { "defaultTrackingMode": "local-first", "canonicalHiddenRoots": [ ".hforge/library/skills", ".hforge/library/rules", ".hforge/library/knowledge", ".hforge/templates", ".hforge/runtime", ".hforge/state", ".hforge/generated" ], "visibleBridgeRoots": [ "AGENTS.md", "CLAUDE.md", ".agents/skills", ".codex", ".claude" ] }, "requiredPaths": [ "README.md", "AGENTS.md", "CONTRIBUTING.md", "CHANGELOG.md", "RESEARCH-SOURCES.md", "VALIDATION.md", "install.sh", "install.ps1", ".agents/skills/speckit-implement/SKILL.md", ".agents/skills/speckit-plan/SKILL.md", ".agents/skills/speckit-specify/SKILL.md", ".agents/skills/speckit-tasks/SKILL.md", ".agents/skills/repo-onboarding/SKILL.md", ".agents/skills/architecture-decision-records/SKILL.md", ".agents/skills/api-contract-review/SKILL.md", ".agents/skills/db-migration-review/SKILL.md", ".agents/skills/parallel-worktree-supervisor/SKILL.md", ".agents/skills/repo-modernization/SKILL.md", ".agents/skills/typescript-engineering/SKILL.md", ".agents/skills/lua-engineering/SKILL.md", ".agents/skills/powershell-engineering/SKILL.md", ".agents/skills/javascript-engineering/SKILL.md", ".agents/skills/cloud-architect/SKILL.md", ".agents/skills/recursive-structured-analysis/SKILL.md", ".agents/skills/token-budget-optimizer/SKILL.md", ".agents/skills/complex-task-protocol/SKILL.md", ".agents/skills/double-diamond-feature/SKILL.md", ".agents/skills/bug-investigation/SKILL.md", "docs/catalog/language-packs.md", "docs/catalog/framework-packs.md", "docs/templates/authoring.md", "docs/authoring/skills.md", "docs/authoring/engineering-assistant-port.md", "docs/authoring/enhanced-skill-import.md", "docs/authoring/token-budget-optimizer-port.md", "docs/flow-orchestration.md", "docs/generated-artifacts.md", "docs/hooks/catalog.md", "docs/profile-guide.md", "docs/target-support-matrix.md", "docs/maintenance-lifecycle.md", "docs/get-started/index.md", "docs/get-started/adopter.md", "docs/get-started/maintainer.md", "docs/get-started/pack-author.md", "docs/get-started/troubleshooting.md", "docs/observability.md", "docs/recursive-rlm-guide.md", "docs/benchmark-scenarios.md", "docs/release-process.md", "commands/hforge-analyze.md", "commands/hforge-cartograph.md", "commands/hforge-commands.md", "commands/hforge-decide.md", "commands/hforge-init.md", "commands/hforge-recommend.md", "commands/hforge-recursive.md", "commands/hforge-recursive-investigate.md", "commands/hforge-refresh.md", "commands/hforge-review.md", "commands/hforge-status.md", "commands/hforge-task.md", "commands/hforge-update.md", "commands/hforge-double-diamond.md", "commands/hforge-bug-diamond.md", "commands/plan.md", "commands/test.md", ".agents/skills/hforge-analyze/SKILL.md", ".agents/skills/hforge-recursive-investigate/SKILL.md", ".agents/skills/hforge-decide/SKILL.md", ".agents/skills/hforge-init/SKILL.md", ".agents/skills/hforge-refresh/SKILL.md", ".agents/skills/hforge-review/SKILL.md", "knowledge-bases/seeded/README.md", "rules/common/README.md", "skills/README.md", "skills/engineering-assistant/SKILL.md", "skills/hforge-analyze/SKILL.md", "skills/hforge-recursive-investigate/SKILL.md", "skills/hforge-decide/SKILL.md", "skills/hforge-init/SKILL.md", "skills/hforge-refresh/SKILL.md", "skills/hforge-review/SKILL.md", "skills/typescript-engineering/SKILL.md", "skills/lua-engineering/SKILL.md", "skills/powershell-engineering/SKILL.md", "skills/javascript-engineering", "skills/cloud-architect", "skills/recursive-structured-analysis/SKILL.md", "skills/token-budget-optimizer/SKILL.md", "skills/complex-task-protocol/SKILL.md", "skills/double-diamond-feature/SKILL.md", "skills/bug-investigation/SKILL.md", "skills/token-budget-optimizer/references/audit-dimensions.md", "skills/token-budget-optimizer/references/promotion-ladder.md", "skills/token-budget-optimizer/references/scoring-model.md", "skills/token-budget-optimizer/references/report-template.md", "skills/token-budget-optimizer/scripts/inspect_token_surfaces.py", "skills/repo-onboarding/SKILL.md", "skills/documentation-lookup/SKILL.md", "skills/security-scan/SKILL.md", "skills/release-readiness/SKILL.md", "skills/architecture-decision-records/SKILL.md", "skills/parallel-worktree-supervisor/SKILL.md", "skills/incident-triage/SKILL.md", "skills/dependency-upgrade-safety/SKILL.md", "skills/performance-profiling/SKILL.md", "skills/test-strategy-and-coverage/SKILL.md", "skills/api-contract-review/SKILL.md", "skills/db-migration-review/SKILL.md", "skills/pr-triage-and-summary/SKILL.md", "skills/observability-setup/SKILL.md", "skills/repo-modernization/SKILL.md", "templates/workflows/implement-typescript-change.md", "templates/workflows/implement-java-change.md", "templates/workflows/implement-dotnet-change.md", "templates/workflows/implement-lua-change.md", "templates/workflows/implement-powershell-change.md", "scripts/templates/README.md", "scripts/templates/config/required-sections.json", "scripts/templates/shell/check-template-frontmatter.sh", "scripts/templates/shell/check-template-links.sh", "scripts/templates/shell/list-missing-template-sections.sh", "scripts/templates/shell/generate-template-index.sh", "scripts/templates/shell/verify-workflow-contracts.sh", "scripts/templates/powershell/Check-TemplateFrontmatter.ps1", "scripts/templates/powershell/Check-TemplateLinks.ps1", "scripts/templates/powershell/Get-MissingTemplateSections.ps1", "scripts/templates/powershell/New-TemplateIndex.ps1", "scripts/templates/powershell/Test-WorkflowContracts.ps1", "scripts/intelligence/scan-repo.mjs", "scripts/intelligence/cartograph-repo.mjs", "scripts/intelligence/classify-boundaries.mjs", "scripts/intelligence/detect-frameworks.mjs", "scripts/intelligence/score-recommendations.mjs", "scripts/intelligence/synthesize-instructions.mjs", "scripts/runtime/flow-status.mjs", "scripts/runtime/recursive-plan.mjs", "scripts/runtime/report-effectiveness.mjs", "scripts/knowledge/import-pack.mjs", "scripts/knowledge/normalize-pack.mjs", "scripts/knowledge/report-coverage.mjs", "scripts/knowledge/report-drift.mjs", "scripts/ci/generate-compatibility-matrix.mjs", "scripts/ci/validate-no-placeholders.mjs", "scripts/ci/validate-skill-depth.mjs", "scripts/ci/validate-framework-coverage.mjs", "scripts/ci/validate-doc-command-alignment.mjs", "scripts/ci/validate-manifest-runtime-consistency.mjs", "skills/repo-onboarding/references/discovery-checklist.md", "skills/architecture-decision-records/references/decision-rubric.md", "skills/api-contract-review/references/review-template.md", "skills/db-migration-review/references/review-template.md", "skills/parallel-worktree-supervisor/references/output-template.md", "skills/repo-modernization/references/roadmap-template.md", "skills/typescript-engineering/references/workspace-and-monorepo.md", "skills/lua-engineering/references/runtime-profiles.md", "skills/javascript-engineering/references/package-contracts.md", "skills/engineering-assistant/references/architecture.md", "skills/engineering-assistant/references/project-notes.md", "skills/engineering-assistant/references/change-discipline.md", "knowledge-bases/seeded/typescript", "knowledge-bases/seeded/java", "knowledge-bases/seeded/dotnet", "knowledge-bases/seeded/lua", "knowledge-bases/seeded/powershell", "manifests/catalog/index.json", "manifests/catalog/language-assets.json", "manifests/catalog/framework-assets.json", "manifests/catalog/compatibility-matrix.json", "manifests/catalog/flow-artifacts.json", "manifests/catalog/engineering-assistant-import-inventory.json", "manifests/catalog/enhanced-skill-import-inventory.json", "manifests/catalog/token-budget-optimizer-import-inventory.json", "manifests/catalog/seeded-knowledge-files.json", "manifests/catalog/package-surface.json", "manifests/hooks/index.json", "schemas/runtime/file-interest.schema.json", "schemas/runtime/impact-analysis.schema.json", "schemas/runtime/architecture-significance.schema.json", "schemas/runtime/decision-record.schema.json", "schemas/runtime/decision-coverage-summary.schema.json", "schemas/runtime/task-pack.schema.json", "schemas/runtime/working-memory.schema.json", "schemas/runtime/recursive-session.schema.json", "schemas/runtime/recursive-budget.schema.json", "schemas/runtime/recursive-execution-policy.schema.json", "schemas/runtime/recursive-action-bundle.schema.json", "schemas/runtime/recursive-iteration.schema.json", "schemas/runtime/recursive-subcall.schema.json", "schemas/runtime/recursive-memory.schema.json", "schemas/runtime/recursive-checkpoint.schema.json", "schemas/runtime/recursive-final-output.schema.json", "schemas/runtime/recursive-code-cell.schema.json", "schemas/runtime/recursive-promotion-proposal.schema.json", "schemas/runtime/recursive-meta-op-proposal.schema.json", "schemas/runtime/recursive-scorecard.schema.json", "schemas/runtime/recursive-language-capabilities.schema.json", "schemas/runtime/recursive-runtime-inventory.schema.json", "schemas/runtime/recursive-escalation-heuristics.schema.json", "schemas/runtime/pack-manifest.schema.json", "schemas/runtime/installed-packs.schema.json", "schemas/runtime/selected-profile.schema.json", "schemas/runtime/materialization-index.schema.json", "schemas/runtime/provenance-index.schema.json", "schemas/runtime/update-action-plan.schema.json", "schemas/runtime/extension-manifest.schema.json", "schemas/runtime/intelligence-cache-entry.schema.json", "schemas/runtime/execution-policy.schema.json", "schemas/runtime/coherence-report.schema.json", "schemas/runtime/recommendation-evidence.schema.json", "schemas/runtime/recursive-run-result.schema.json", "schemas/runtime/recursive-run-meta.schema.json", "schemas/runtime/recursive-trace-event.schema.json", "schemas/runtime/recursive-session-summary.schema.json", "schemas/runtime/recursive-adr-candidate.schema.json", "schemas/templates/runtime-template-registry.schema.json", "schemas/templates/recursive-template-registry.schema.json", "manifests/profiles/core.json", "manifests/profiles/developer.json", "manifests/profiles/reviewer.json", "manifests/profiles/security.json", "manifests/profiles/release-manager.json", "manifests/profiles/rapid-prototyping.json", "manifests/profiles/legacy-modernization.json", "manifests/profiles/research-first.json", "manifests/profiles/game-dev-native.json", "manifests/profiles/ai-runtime.json", "hooks/README.md", "mcp/README.md", "profiles/README.md", "scripts/codex/apply-home-config.mjs", "targets/claude-code/runtime/.claude/settings.json", "targets/codex/runtime/.codex/config.toml", "targets/generic-agent/runtime/AGENTS-bridge.md", "targets/cursor/adapter.json", "targets/opencode/adapter.json", ".agents/skills/madr-decision-log/SKILL.md", ".agents/skills/madr-decision-log/agents/openai.yaml", ".agents/skills/madr-decision-log/agents/claude.yaml", "skills/madr-decision-log/SKILL.md", "skills/madr-decision-log/references/adr-template.md", "skills/madr-decision-log/references/madr-reference.md", "skills/madr-decision-log/references/review-checklist.md", "skills/madr-decision-log/scripts/new_adr.py", "skills/madr-decision-log/scripts/validate_madr.py", "skills/madr-decision-log/scripts/build_log.py", ".agents/skills/impact-analysis/SKILL.md", ".agents/skills/impact-analysis/agents/openai.yaml", ".agents/skills/impact-analysis/agents/claude.yaml", "skills/impact-analysis/SKILL.md", "skills/impact-analysis/references/examples.md", "skills/impact-analysis/references/impact-lenses.md", "skills/impact-analysis/references/output-template.md", "skills/impact-analysis/references/scoring-model.md", "skills/impact-analysis/scripts/impact_score.py", "skills/impact-analysis/assets/sample-scorecard.json" ], "groups": [ { "id": "root-docs", "description": "Front-door, lifecycle, compatibility, and interactive-entry docs required for supported harnesses.", "paths": [ "README.md", "AGENTS.md", "CONTRIBUTING.md", "CHANGELOG.md", "RESEARCH-SOURCES.md", "VALIDATION.md", "docs/quickstart.md", "docs/installation.md", "docs/targets.md", "docs/languages.md", "docs/commands.md", "docs/agents.md", "docs/hooks/catalog.md", "docs/flow-orchestration.md", "docs/generated-artifacts.md", "docs/profile-guide.md", "docs/target-support-matrix.md", "docs/maintenance-lifecycle.md", "docs/get-started/index.md", "docs/get-started/adopter.md", "docs/get-started/maintainer.md", "docs/get-started/pack-author.md", "docs/get-started/troubleshooting.md", "docs/release-process.md", "docs/recursive-rlm-guide.md", "docs/authoring/engineering-assistant-port.md", "docs/authoring/token-budget-optimizer-port.md", "docs/observability.md", "docs/benchmark-scenarios.md", "docs/troubleshooting.md", "docs/versioning-and-migration.md", "commands/hforge-analyze.md", "commands/hforge-cartograph.md", "commands/hforge-commands.md", "commands/hforge-decide.md", "commands/hforge-init.md", "commands/hforge-recommend.md", "commands/hforge-recursive.md", "commands/hforge-recursive-investigate.md", "commands/hforge-refresh.md", "commands/hforge-review.md", "commands/hforge-status.md", "commands/hforge-task.md", "commands/hforge-update.md", "commands/hforge-double-diamond.md", "commands/hforge-bug-diamond.md", "commands/plan.md", "commands/test.md", "hooks", "mcp", "profiles" ] }, { "id": "seeded-knowledge", "description": "Seeded language packs shipped directly in the package.", "paths": [ "knowledge-bases/seeded/README.md", "knowledge-bases/seeded/typescript", "knowledge-bases/seeded/java", "knowledge-bases/seeded/dotnet", "knowledge-bases/seeded/lua", "knowledge-bases/seeded/powershell" ] }, { "id": "promoted-language-surfaces", "description": "Operational rule, skill, and workflow surfaces promoted from the seeded language packs.", "paths": [ "rules/common", "rules/typescript", "rules/java", "rules/dotnet", "rules/lua", "rules/powershell", "skills/engineering-assistant", "skills", "templates/workflows/implement-typescript-change.md", "templates/workflows/implement-java-change.md", "templates/workflows/implement-dotnet-change.md", "templates/workflows/implement-lua-change.md", "templates/workflows/implement-powershell-change.md" ] }, { "id": "operational-runtime", "description": "Recommendation, shared-runtime hydration, flow, observability, and knowledge-maintenance scripts.", "paths": [ "scripts/intelligence", "scripts/runtime", "scripts/runtime/recursive-plan.mjs", "scripts/knowledge" ] }, { "id": "shared-runtime-sources", "description": "Shipped guidance and runtime sources that compile into the hidden `.hforge/` AI layer during install.", "paths": [ "docs/installation.md", "docs/install/targets.md", "docs/flow-orchestration.md", "docs/generated-artifacts.md", "docs/repo-cartography.md", "templates/instructions", "scripts/intelligence", "scripts/runtime" ] }, { "id": "validator-bundle", "description": "Shipped task, workflow, and release validation bundle.", "paths": [ "scripts/templates/README.md", "scripts/templates/config/required-sections.json", "scripts/templates/shell", "scripts/templates/powershell", "scripts/ci" ] }, { "id": "catalog-and-contracts", "description": "Manifest and schema files required for packaging and release checks.", "paths": [ "manifests/catalog/index.json", "manifests/catalog/language-assets.json", "manifests/catalog/framework-assets.json", "manifests/catalog/compatibility-matrix.json", "manifests/catalog/flow-artifacts.json", "manifests/catalog/seeded-knowledge-files.json", "manifests/catalog/package-surface.json", "manifests/hooks/index.json", "manifests/profiles", "schemas/content/content-metadata.schema.json", "schemas/hooks/hook.schema.json", "schemas/runtime/file-interest.schema.json", "schemas/runtime/impact-analysis.schema.json", "schemas/runtime/architecture-significance.schema.json", "schemas/runtime/decision-record.schema.json", "schemas/runtime/decision-coverage-summary.schema.json", "schemas/runtime/task-pack.schema.json", "schemas/runtime/working-memory.schema.json", "schemas/runtime/recursive-session.schema.json", "schemas/runtime/recursive-budget.schema.json", "schemas/runtime/recursive-trace-event.schema.json", "schemas/runtime/recursive-session-summary.schema.json", "schemas/runtime/recursive-adr-candidate.schema.json", "schemas/runtime/recursive-runtime-inventory.schema.json", "schemas/runtime/recursive-escalation-heuristics.schema.json", "schemas/runtime/pack-manifest.schema.json", "schemas/runtime/installed-packs.schema.json", "schemas/runtime/selected-profile.schema.json", "schemas/runtime/materialization-index.schema.json", "schemas/runtime/provenance-index.schema.json", "schemas/runtime/update-action-plan.schema.json", "schemas/runtime/extension-manifest.schema.json", "schemas/runtime/intelligence-cache-entry.schema.json", "schemas/runtime/execution-policy.schema.json", "schemas/runtime/coherence-report.schema.json", "schemas/runtime/recommendation-evidence.schema.json", "schemas/templates/runtime-template-registry.schema.json", "schemas/templates/recursive-template-registry.schema.json", "schemas/manifests/seeded-knowledge-files.schema.json", "schemas/manifests/package-surface.schema.json", "schemas/runtime/flow-state.schema.json" ] }, { "id": "embedded-skill-governance", "description": "Inventory, provenance, and sentinel references that keep imported skill packs reviewable and shippable.", "paths": [ "manifests/catalog/engineering-assistant-import-inventory.json", "docs/authoring/engineering-assistant-port.md", "docs/authoring/token-budget-optimizer-port.md", "skills/engineering-assistant/references/architecture.md", "skills/engineering-assistant/references/project-notes.md", "skills/engineering-assistant/references/change-discipline.md", "manifests/catalog/enhanced-skill-import-inventory.json", "manifests/catalog/token-budget-optimizer-import-inventory.json", "docs/authoring/enhanced-skill-import.md", "docs/authoring/token-budget-optimizer-port.md", "skills/repo-onboarding/references/discovery-checklist.md", "skills/architecture-decision-records/references/decision-rubric.md", "skills/api-contract-review/references/review-template.md", "skills/db-migration-review/references/review-template.md", "skills/parallel-worktree-supervisor/references/output-template.md", "skills/repo-modernization/references/roadmap-template.md", "skills/typescript-engineering/references/workspace-and-monorepo.md", "skills/lua-engineering/references/runtime-profiles.md", "skills/javascript-engineering/references/package-contracts.md" ] }, { "id": "target-runtime", "description": "Target-native runtime bridges plus support-honesty adapters that route into the hidden `.hforge/` AI layer.", "paths": [ "targets/claude-code/runtime/.claude", "targets/codex/runtime/.codex", "targets/cursor/adapter.json", "targets/opencode/adapter.json", "scripts/codex" ] } ], "targetSurfaces": [ { "target": "codex", "paths": [ "AGENTS.md", ".agents/skills", ".agents/skills/repo-onboarding/SKILL.md", ".agents/skills/hforge-analyze/SKILL.md", ".agents/skills/hforge-recursive-investigate/SKILL.md", ".agents/skills/hforge-decide/SKILL.md", ".agents/skills/hforge-init/SKILL.md", ".agents/skills/hforge-refresh/SKILL.md", ".agents/skills/hforge-review/SKILL.md", ".agents/skills/architecture-decision-records/SKILL.md", ".agents/skills/api-contract-review/SKILL.md", ".agents/skills/db-migration-review/SKILL.md", ".agents/skills/parallel-worktree-supervisor/SKILL.md", ".agents/skills/repo-modernization/SKILL.md", ".agents/skills/typescript-engineering/SKILL.md", ".agents/skills/lua-engineering/SKILL.md", ".agents/skills/powershell-engineering/SKILL.md", ".agents/skills/javascript-engineering/SKILL.md", ".agents/skills/cloud-architect/SKILL.md", ".agents/skills/recursive-structured-analysis/SKILL.md", ".agents/skills/token-budget-optimizer/SKILL.md", "targets/codex/adapter.json", "targets/codex/runtime/.codex", "scripts/codex/apply-home-config.mjs", "mcp" ] }, { "target": "claude-code", "paths": [ "AGENTS.md", ".agents/skills", ".agents/skills/repo-onboarding/SKILL.md", ".agents/skills/hforge-analyze/SKILL.md", ".agents/skills/hforge-recursive-investigate/SKILL.md", ".agents/skills/hforge-decide/SKILL.md", ".agents/skills/hforge-init/SKILL.md", ".agents/skills/hforge-refresh/SKILL.md", ".agents/skills/hforge-review/SKILL.md", ".agents/skills/architecture-decision-records/SKILL.md", ".agents/skills/api-contract-review/SKILL.md", ".agents/skills/db-migration-review/SKILL.md", ".agents/skills/parallel-worktree-supervisor/SKILL.md", ".agents/skills/repo-modernization/SKILL.md", ".agents/skills/typescript-engineering/SKILL.md", ".agents/skills/lua-engineering/SKILL.md", ".agents/skills/powershell-engineering/SKILL.md", ".agents/skills/javascript-engineering/SKILL.md", ".agents/skills/cloud-architect/SKILL.md", ".agents/skills/recursive-structured-analysis/SKILL.md", ".agents/skills/token-budget-optimizer/SKILL.md", "targets/claude-code/adapter.json", "targets/claude-code/runtime/.claude", "hooks" ] }, { "target": "cursor", "paths": [ "docs/target-support-matrix.md", "manifests/catalog/compatibility-matrix.json", "targets/cursor/adapter.json" ] }, { "target": "opencode", "paths": [ "docs/target-support-matrix.md", "manifests/catalog/compatibility-matrix.json", "targets/opencode/adapter.json" ] } ] }