spec-kit-project-cognition-gate

Enforce live-file evidence for technical claims in Spec Kit Plus brownfield repositories.

7|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/chenziyang110/spec-kit-plus --skill spec-kit-project-cognition-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-kit-project-cognition-gate
Source: https://github.com/chenziyang110/spec-kit-plus/tree/main/templates/passive-skills/spec-kit-project-cognition-gate
Command: npx skills add https://github.com/chenziyang110/spec-kit-plus --skill spec-kit-project-cognition-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents confident-but-wrong edits and architecture decisions by forcing advisory project cognition to be used only for navigation, then proving technical claims from live repository evidence.

Core Features & Use Cases

  • Advisory navigation for brownfield work: Uses the active workflow’s project cognition bundle to choose minimal reads, relevant surfaces, and verification routes before any source grounding.
  • Concept selection governance: Guides how to plan with project-cognition lexicon candidates, rank/filter via the user request, record selected and rejected concepts, and carry decisions forward into project-cognition query.
  • Evidence discipline across repos: Supports cross-project references only when cognition runtimes are fresh and ready, otherwise blocks technical claims and falls back to minimal live reads plus explicit map-maintenance when requested.

Quick Start

Use this skill when you are changing or debugging an existing Spec Kit Plus repository and must base technical recommendations on minimal live evidence while following the active workflow’s project cognition contract.

Frequently Asked Questions about spec-kit-project-cognition-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent confident but wrong code edits in a brownfield codebase?

To validate technical claims in brownfield codebases, you enforce minimal live-read constraints and prove recommendations directly from active source files rather than relying on graph JSON artifacts. This prevents speculative technical decisions during debugging and code review.

What is spec-driven development project cognition for existing repositories?

Project cognition for existing repositories is an advisory navigation mechanism that uses a cognition bundle to select minimal reads and verification routes before source grounding. It governs concept selection ranking, filtering, and carry-forward during planning and implementation workflows.

How do I verify cross-repo references during spec-driven codebase auditing?

Verifying cross-repo references during codebase auditing requires checking that project cognition runtimes are fresh and ready across all referenced projects. If runtimes are stale, technical claims are blocked and you fall back to minimal live reads plus explicit map-maintenance.

Can I use graph JSON artifacts to debug changes in a Spec Kit Plus repository?

You cannot use graph JSON artifacts alone to debug changes in a Spec Kit Plus repository. The skill mandates that all technical claims be proved from live files, enforcing evidence-based changes through minimal live reads instead of relying on cached artifacts.

When should I not use advisory project cognition for codebase auditing?

You should not use advisory project cognition for codebase auditing when cross-project cognition runtimes are not fresh. In this state, the system blocks technical claims and requires falling back to minimal live reads plus explicit map-maintenance when requested.