architectural-planning

Create technical implementation plans with atomic steps, file paths, and success criteria.

2|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/vanillacake369/tonys-nix --skill architectural-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architectural-planning
Source: https://github.com/vanillacake369/tonys-nix/tree/main/dotfiles/claude/skills/architectural-planning
Command: npx skills add https://github.com/vanillacake369/tonys-nix --skill architectural-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create detailed, actionable technical plans for new features or system changes, ensuring they integrate seamlessly with the existing architecture. It prevents costly rework and ensures consistency by leveraging established project patterns, allowing for smooth development and deployment.

Core Features & Use Cases

  • Context-Aware Design: Analyzes existing architectural patterns (layered, microservices, hexagonal, event-driven) and designs solutions that respect boundaries and responsibilities.
  • Actionable Implementation Roadmaps: Breaks down complex features into atomic, ordered steps, specifying exact file modifications and referencing existing code examples.
  • Risk & Validation Planning: Identifies dependencies, potential conflicts, breaking changes, and outlines comprehensive testing strategies and success criteria.
  • Use Case: You need to add a new payment gateway integration to an existing microservices architecture. Use this Skill to generate a detailed plan that outlines service boundaries, communication patterns (e.g., Kafka events), and specific code changes, all while matching the project's existing integration patterns.

Quick Start

Generate an implementation plan for adding a new Product entity, including database schema, API endpoints, and service logic, ensuring it aligns with the existing layered architecture.

Frequently Asked Questions about architectural-planning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a technical plan for adding features to an existing system architecture?

Technical planning for new features involves analyzing your existing architectural patterns, then designing solutions that respect system boundaries and responsibilities. Break the feature into atomic, ordered steps with specific file paths, API references, and success criteria to ensure seamless integration.

What's the best way to plan a system migration or integration without breaking existing code?

Plan migrations and integrations by identifying dependencies, potential conflicts, and breaking changes upfront. Map communication patterns to your architecture (microservices, layered, event-driven), specify exact code modifications aligned with established patterns, and define comprehensive testing strategies.

How do I identify risks and dependencies before implementing architectural changes?

Risk identification in architectural planning examines how new components interact with existing modules, traces data flow through service boundaries, flags breaking changes, and defines atomic testable steps. This prevents costly rework by catching integration issues during the planning phase.

Can I use architectural planning for multi-module changes across different codebases?

Yes, architectural planning applies to multi-module changes by analyzing project-wide patterns and designing solutions that maintain consistency across codebases. It specifies which files and APIs change in each module and how they communicate, ensuring coordinated deployment.

What should an implementation roadmap include for a new payment gateway integration?

An implementation roadmap specifies service boundaries, communication patterns (like event-driven messaging), exact code changes with file paths, existing code examples to follow, and success criteria. It ensures the integration matches your architecture's established patterns for consistency.