Skip to content
Agent Memory
Command

/spec

Manage specifications in our development process

BOOST
From plugin
basic-memory
4.1k5 skills5 commands1 MCP
Install
> /plugin marketplace add basicmachines-co/basic-memory
> /plugin install basic-memory@basicmachines-co

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/spec

Context preview

What this command does when you run it.

Manage specifications in our development process

Command definition

spec.md
allowed-tools: mcp__basic-memory__write_note, mcp__basic-memory__read_note, mcp__basic-memory__search_notes, mcp__basic-memory__edit_note
argument-hint: [create|status|show|review] [spec-name]
description: Manage specifications in our development process

Context

Specifications are managed in the Basic Memory "specs" project. All specs live in a centralized location accessible across all repositories via MCP tools.

See SPEC-1 and SPEC-2 in the "specs" project for the full specification-driven development process.

Available commands:

  • `create [name]` - Create new specification
  • `status` - Show all spec statuses
  • `show [spec-name]` - Read a specific spec
  • `review [spec-name]` - Review implementation against spec

Your task

Execute the spec command: `/spec $ARGUMENTS`

If command is "create":

1. Get next SPEC number by searching existing specs in "specs" project 2. Create new spec using template from SPEC-2 3. Use mcp__basic-memory__write_note with project="specs" 4. Include standard sections: Why, What, How, How to Evaluate

If command is "status":

1. Use mcp__basic-memory__search_notes with project="specs" 2. Display table with spec number, title, and progress 3. Show completion status from checkboxes in content

If command is "show":

1. Use mcp__basic-memory__read_note with project="specs" 2. Display the full spec content

If command is "review":

1. Read the specified spec and its "How to Evaluate" section 2. Review the implementation against each success criterion: which specified behavior works, which tests cover it (`tests/`, `test-int/`), and whether `just check` and the relevant `just test-*` targets pass. 3. Update the spec with the findings via mcp__basic-memory__edit_note, marking each criterion met or unmet with evidence; list unmet criteria as remaining work.

Read more
Ships withbasic-memory

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

Get the whole plugin

Other commands on basic-memory.