From agentic-toolkit
Create comprehensive architecture blueprints for new services or features with production-ready design and multi-phase implementation plans
npx claudepluginhub corbinatorx/devops-ai-toolkit-claude-plugin --plugin agentic-toolkitThis skill is limited to using the following tools:
Creates comprehensive architecture blueprints for new services or features following industry best practices. Generates production-ready designs with domain modeling, technical architecture, API specifications, and multi-phase implementation plans.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Designs, implements, and audits WCAG 2.2 AA accessible UIs for Web (ARIA/HTML5), iOS (SwiftUI traits), and Android (Compose semantics). Audits code for compliance gaps.
Creates comprehensive architecture blueprints for new services or features following industry best practices. Generates production-ready designs with domain modeling, technical architecture, API specifications, and multi-phase implementation plans.
This Skill delegates the actual blueprint creation to the software-architect agent, which provides expert architectural guidance.
Blueprint and task paths default to .agentic/blueprints/active/ and .agentic/tasks/active/. These can be overridden via .claude/config.json:
{
"documentation": {
"blueprintPath": ".agentic/blueprints/active",
"taskPath": ".agentic/tasks/active"
}
}
If documentation.blueprintPath is set in config, use that path instead of the default.
This Skill automatically activates when users mention:
"Design a payment processing service with Stripe integration"
"Create blueprint for user notification system with email and push"
"I need architecture for a real-time analytics dashboard"
"Blueprint for order management system"
CRITICAL: Before beginning, read .claude/config.json to understand:
If .claude/config.json doesn't exist:
If .claude/examples/ directory exists:
Ask the user for:
Invoke the software-architect agent to create the blueprint. The agent will generate a comprehensive design including:
11+ Required Sections:
File Location: .agentic/blueprints/active/{service-or-feature-name}-blueprint.md
Filename Convention:
payment-service-blueprint.mduser-profile-feature-blueprint.mdanalytics-dashboard-blueprint.mdCreate directory if needed:
mkdir -p .agentic/blueprints/active
After saving the blueprint, provide:
Domain Overview:
Data Model:
Technical Architecture:
Component Overview:
Data Model:
Technical Architecture:
Blueprints include 4-6 week-long phases:
Each phase:
MVP Completion Checklist included with concrete deliverables.
Blueprints provide concrete code examples in the project's language:
Backend Entity Example:
// .NET example
public class Order : BaseEntity
{
public string OrderNumber { get; private set; }
public decimal TotalAmount { get; private set; }
public OrderStatus Status { get; private set; }
private readonly List<OrderItem> _items = new();
public IReadOnlyCollection<OrderItem> Items => _items.AsReadOnly();
public static Order Create(string customerId, List<OrderItem> items)
{
// Validation and creation logic
}
}
Frontend Component Example:
// React + TypeScript example
interface UserProfileProps {
userId: string;
onUpdate?: (user: User) => void;
}
export const UserProfile: React.FC<UserProfileProps> = ({ userId, onUpdate }) => {
const [user, setUser] = useState<User | null>(null);
const [isLoading, setIsLoading] = useState(true);
// Component logic
};
All Projects:
Backend Specific:
Frontend Specific:
Before finalizing blueprint, ensure:
.agentic/blueprints/active/ directoryDownstream Skills:
/blueprint-tasks command - Converts blueprint into phase task files (.agentic/tasks/active/)implement-task Skill - Builder references blueprint for architectural contextreview-task Skill - Manager validates implementation against blueprintAgent Delegation:
If .claude/config.json doesn't exist:
❌ Configuration file not found
.claude/config.json is required for blueprint creation.
Please provide:
- Project type (backend/frontend/fullstack/mobile)
- Tech stack (dotnet/nodejs/python/react/etc.)
- Architecture pattern (clean-architecture/mvc/hexagonal/etc.)
- Naming conventions
- Testing framework
If user request is too vague:
❌ Insufficient detail for blueprint
Please provide more information:
- What service/feature are you building?
- What problem does it solve?
- What are the key use cases?
- What does it integrate with?
If unable to create .agentic/blueprints/active/ directory or save file:
❌ Failed to save blueprint
Error: {error message}
Troubleshooting:
- Check write permissions for .claude/ directory
- Verify disk space availability
- Try saving manually to: .agentic/blueprints/active/{name}-blueprint.md
Commands:
/blueprint-tasks - Convert blueprint to phase task files/commit - Commit blueprint to version control/create-pr - Create PR with blueprint changesSkills:
implement-task - Implement tasks from phase files (references blueprint)review-task - Validate implementation (checks against blueprint)Agents: