save_decision
Log significant technical choices with rationale and impact, creating a decision history that maintains consistency and guides future work.
Instructions
CRITICAL: Record important architectural and technical decisions for future reference.
MANDATORY: Call this whenever you make significant technical choices. This builds the project's decision history and helps maintain consistency across the codebase.
WHEN TO USE (Always save decisions for):
Choosing a framework or library (React vs Vue, Flask vs FastAPI, etc.)
Database selection (PostgreSQL vs MongoDB, Redis vs Memcached)
Architecture patterns (Microservices vs Monolith, MVC vs Clean Architecture)
API design choices (REST vs GraphQL, authentication methods)
Infrastructure decisions (Cloud provider, containerization, CI/CD approach)
Security implementations (auth strategy, encryption methods)
Performance optimizations (caching strategy, database indexing)
Any decision that affects the project's direction or maintainability
WHY THIS MATTERS:
Other agents (or you later) will understand WHY choices were made
Prevents inconsistent approaches across the codebase
Documents the evolution of the architecture
Helps onboard new team members
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Categorization tags - e.g., ["architecture", "security", "database"] (optional) | |
| title | Yes | Short, clear decision title - e.g., "Use JWT for Authentication" | |
| impact | No | Expected impact on the project (performance, complexity, maintenance) (optional) | |
| context | No | Background information that led to this decision (optional) | |
| rationale | Yes | WHY this decision was made - the reasoning, trade-offs, alternatives considered | |
| project_id | No | Project ID from create_project() (optional if project_name or workspace_path provided) | |
| description | Yes | Detailed description of what was decided and how it will be implemented | |
| author_agent | No | Your agent_id from register_agent() (optional) | |
| project_name | No | Project name to look up (alternative to project_id) | |
| related_files | No | File paths affected by this decision (optional) | |
| workspace_path | No | Workspace directory path (alternative to project_id) |