kbd-assess

To assess a codebase against active phase goals, run an automated assessment tool that reads project identifiers, specifications, and progress data to generate a phase-aligned gap report. This reveals structural gaps to guide work planning.

A phase-aligned codebase assessment is a structured gap report comparing current project source files against active phase goals. You need one when planning development phases to identify missing features and track end-to-end progress.

Generate a gap report for a multi-tech stack project by reading identity files like package.json and Cargo.toml alongside OpenSpec references. This inspects the codebase and writes a structured assessment to the phase directory.

Yes, the codebase assessment works with Rust and Node.js project identifiers by reading files such as Cargo.toml and package.json. It infers the project context from these sources to support multi-tech stack progress tracking.

The best way to track progress across multiple development phases is using an automated assessment that resumes progress data, loads specifications, and writes phase-specific gap reports to an orchestrator directory for continuous alignment.

A codebase assessment fails to resume previous progress data when the orchestrator directory or phase specifications are missing. The tool requires existing progress files and OpenSpec references to resume and write the assessment correctly.