Dude Specifications - Technical Documentation

Document requirements and architecture via the dude: MCP tools.

Quick Start

code

dude:list_specifications { "projectUuid": "..." }   - List specs
dude:create_specification { "project_uuid": "...", "text": "..." }
dude:search { "entityTypes": ["specification"] }    - Find specs

Specification Operations

Listing Specifications

Tool	Description
`dude:list_specifications`	List specs for a project

Parameters:

•projectUuid (required): Project UUID
•parentUuid (optional): Filter to children of parent spec

Getting Specification Details

Tool	Description
`dude:get_specification`	Get single spec details

Parameters:

•uuid (required): Specification UUID

Creating Specifications

Tool	Description
`dude:create_specification`	Create new specification

Parameters:

•project_uuid (required): Project UUID
•text (required): Specification content
•parent_specification_uuid (optional): Parent spec for nesting

Examples:

code

dude:create_specification {
  "project_uuid": "...",
  "text": "AUTH: JWT tokens with 24h expiry. Refresh handled in authMiddleware.js"
}

dude:create_specification {
  "project_uuid": "...",
  "text": "API: POST /users returns 201 with user object on success"
}

Updating Specifications

Tool	Description
`dude:update_specification`	Update existing spec

Parameters:

•uuid (required): Specification UUID
•text (optional): New content
•parent_specification_uuid (optional, nullable): New parent (null for top-level)
•valid (optional): Set validity status (1 = valid, 0 = invalid/deprecated)

Invalidating Specifications

To mark a specification as invalid/deprecated:

code

dude:update_specification { "uuid": "...", "valid": 0 }

To restore validity:

code

dude:update_specification { "uuid": "...", "valid": 1 }

Search for Specifications

Semantic Search

code

dude:search {
  "query": "authentication flow JWT tokens",
  "entityTypes": ["specification"],
  "projectUuid": "optional-project-uuid"
}

Parameters:

•query (required): Natural language search query
•limit (optional): Max results (default: 10)
•threshold (optional): Min similarity 0-1 (default: 0.3)
•entityTypes (optional): Filter to ["specification"]
•projectUuid (optional): Scope to specific project

Keyword Search

code

dude:search_text { "query": "API" }

Parameters:

•query (required): Text to search for

Specification Conventions

Use prefixes to categorize:

•AUTH: - Authentication/authorization
•API: - API contracts
•ARCH: - Architecture decisions
•DATA: - Data models/schemas
•UI: - User interface patterns

Related Skills

•dude:projects: Manage projects and get full project context
•dude:issues: Track bugs and tasks

Tip: Use dude:get_project_context (from dude:projects) to see all specs for a project at once.