[Preset]: Add Verified Codebase Context

[philo-x]

Preset ID

codebase-memory-context

Preset Name

Verified Codebase Context

Version

1.0.1

Description

Generates evidence-qualified repository context with codebase-memory-mcp and applies it across planning, tasks, analysis, and implementation.

Author

Xu Yin (philo-x)

Repository URL

https://github.com/philo-x/spec-kit-preset-codebase-memory-context

Download URL

https://github.com/philo-x/spec-kit-preset-codebase-memory-context/archive/refs/tags/v1.0.1.zip

Documentation URL

https://github.com/philo-x/spec-kit-preset-codebase-memory-context/blob/v1.0.1/README.md

License

MIT

Required Spec Kit Version

=1.0.1

Required Extensions (optional)

No response

Templates Provided

• codebase-context-template — stable schema for .specify/memory/codebase.md

Commands Provided

• speckit.codebase-memory — generates or refreshes verified repository context
• speckit.plan — consumes repository context during planning
• speckit.tasks — anchors tasks in repository structure and conventions
• speckit.analyze — checks artifacts against context and repository evidence
• speckit.implement — loads conventions and validation commands before implementation

Number of Scripts (optional)

No response

Tags

code-intelligence, codebase-memory, architecture, workflow

Key Features

• Generates evidence-qualified repository context from graph discovery and direct source checks.
• Preserves an explicitly marked human-maintained Project Overrides section across refreshes.
• Integrates the context into plan, tasks, analyze, and implement without making the context mandatory.
• Includes generic repository analysis plus a deeper Spring Boot Maven profile.
• Avoids an extra PyYAML/helper-script runtime by reading the installed preset template directly.

Prepared and submitted on behalf of @philo-x by Codex (model: GPT-5).

Testing Checklist

• Preset installs successfully via specify preset add
• Template resolution works correctly after installation
• Documentation is complete and accurate
• Tested on at least one real project

Submission Requirements

• Valid preset.yml manifest included
• Linked README (Documentation URL) explains how to use this preset and includes a valid specify preset add ... command (preferably specify preset add --from <download-url> using the exact download URL)
• LICENSE file included
• GitHub release created with version tag
• Preset ID follows naming conventions (lowercase-with-hyphens)

[philo-x]

Follow-up validation for this preset submission is now published in v1.0.1.

The new validation closes the two limitations that were still open after the initial submission:

• The CI suite now starts codebase-memory-mcp==0.10.8 as a real stdio MCP server, negotiates protocol 2025-06-18, verifies the required tool surface, and completes a read-only tools/call(list_projects) with isError: false.
• A disposable Git repository completed the full context -> plan -> tasks -> analyze -> implement consumer flow. The plan and tasks used the generated repository layout, conventions, and declared validation command; analysis corroborated those choices; implementation was test-first and finished with the original behavior plus new assertions passing.
• The earlier field report remains available for the larger real-repository exercises against the Spec Kit checkout and Spring Petclinic, including graph counts, trace evidence, coverage limitations, and Project Overrides refresh preservation.

Release: https://github.com/philo-x/spec-kit-preset-codebase-memory-context/releases/tag/v1.0.1

MCP and downstream workflow report: https://github.com/philo-x/spec-kit-preset-codebase-memory-context/blob/v1.0.1/docs/validation/v1.0.1.md

Two-repository field report: https://github.com/philo-x/spec-kit-preset-codebase-memory-context/blob/v1.0.1/docs/validation/v1.0.0.md

CI run (Python 3.11 and 3.13): https://github.com/philo-x/spec-kit-preset-codebase-memory-context/actions/runs/32935528333

Validated commit: 34403c302cf1f62acf9ed25cba4b0bfda3d05624

The issue metadata has also been updated from v1.0.0 to v1.0.1 so the download and documentation URLs point to the current immutable release.

Posted on behalf of @philo-x by Codex (model: GPT-5).

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

Pull request created: #4344

Generated by Add Community Preset from Issue Submission · 175.3 AIC · ⌖ 16.4 AIC · ⊞ 36.2K