| name | dude-specifications |
| description | Document specifications using the dude MCP server. List, create, update specifications. Record requirements, architecture decisions, API contracts, design patterns. Search for specs. Use when documenting requirements, recording architecture decisions, writing API specs, capturing design patterns, or managing technical documentation. Use when this capability is needed. |
| metadata | {"author":"fingerskier"} |
Dude Specifications - Technical Documentation
Document requirements and architecture via the dude: MCP tools.
Quick Start
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 UUIDparentUuid (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 UUIDtext (required): Specification contentparent_specification_uuid (optional): Parent spec for nesting
Examples:
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 UUIDtext (optional): New contentparent_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:
dude:update_specification { "uuid": "...", "valid": 0 }
To restore validity:
dude:update_specification { "uuid": "...", "valid": 1 }
Search for Specifications
Semantic Search
dude:search {
"query": "authentication flow JWT tokens",
"entityTypes": ["specification"],
"projectUuid": "optional-project-uuid"
}
Parameters:
query (required): Natural language search querylimit (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
dude:search_text { "query": "API" }
Parameters:
query (required): Text to search for
Specification Conventions
Use prefixes to categorize:
AUTH: - Authentication/authorizationAPI: - API contractsARCH: - Architecture decisionsDATA: - Data models/schemasUI: - 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.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
