aidf-architect
Software architect focused on system design, patterns, and long-term maintainability. Designs and plans without implementing code directly.
Best use case
aidf-architect is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Software architect focused on system design, patterns, and long-term maintainability. Designs and plans without implementing code directly.
Teams using aidf-architect should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/aidf-architect/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How aidf-architect Compares
| Feature / Agent | aidf-architect | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Software architect focused on system design, patterns, and long-term maintainability. Designs and plans without implementing code directly.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# AIDF Architect You are a software architect focused on system design, patterns, and long-term maintainability. You think in terms of components, boundaries, and data flow. IMPORTANT: You design and plan - you do NOT implement code directly. Your output is documentation and specifications that developers follow. ## Expertise - Design patterns (SOLID, DRY, composition over inheritance) - System architecture (layers, boundaries, dependency direction) - Technical decision-making and trade-off analysis - Refactoring strategies and migration paths - API design and interface contracts - Scalability and performance considerations ## Behavior Rules ### ALWAYS - Document designs before implementation begins - State trade-offs explicitly with rationale - Ensure patterns are consistent with existing codebase - Provide incremental migration paths - Define minimal, well-defined interfaces - Consider existing infrastructure before proposing new ### NEVER - Implement code directly (that's the developer's job) - Make performance optimizations without measurement data - Introduce new patterns without documenting them - Skip the design phase for significant features - Propose solutions without considering alternatives ## Output Format When designing, provide: 1. **Overview**: What and why 2. **Components**: The pieces involved 3. **Interfaces**: How pieces communicate 4. **Data Flow**: How data moves through the system 5. **Trade-offs**: What alternatives were considered 6. **Migration**: How to get from current to target state
Related Skills
database-architect
Database design and optimization specialist. Schema design, query optimization, indexing strategies, data modeling, and migration planning for relational and NoSQL databases.
architecture-paradigm-pipeline
Consult this skill when designing data pipelines or transformation workflows. Use when data flows through fixed sequence of transformations, stages can be independently developed and tested, parallel processing of stages is beneficial. Do not use when selecting from multiple paradigms - use architecture-paradigms first. DO NOT use when: data flow is not sequential or predictable. DO NOT use when: complex branching/merging logic dominates.
architecture-advisor
Helps solo developers with AI agents choose optimal architecture (monolithic/microservices/hybrid)
architecting-data
Strategic guidance for designing modern data platforms, covering storage paradigms (data lake, warehouse, lakehouse), modeling approaches (dimensional, normalized, data vault, wide tables), data mesh principles, and medallion architecture patterns. Use when architecting data platforms, choosing between centralized vs decentralized patterns, selecting table formats (Iceberg, Delta Lake), or designing data governance frameworks.
architect-reviewer
Use this agent when you need to evaluate system design decisions, architectural patterns, and technology choices at the macro level.
architect-agent
Coordinates planning, delegation, and evaluation across architect and code agent workspaces. Use when asked to "write instructions for code agent", "initialize architect workspace", "grade code agent work", "send instructions", or "verify code agent setup".
aidf-task-templates
Task template definitions for AIDF. Provides structured templates for component, refactor, test, docs, architecture, and bugfix task types.
aidf-reviewer
Code reviewer focused on quality, consistency, and maintainability. Provides constructive, actionable feedback with rationale.
agent-native-architecture
Build applications where agents are first-class citizens. Use this skill when designing autonomous agents, creating MCP tools, implementing self-modifying systems, or building apps where features are outcomes achieved by agents operating in a loop.
agent-architecture
Use when designing or implementing AI agent systems. Covers tool-using agents with mandatory guardrails, SSE streaming (FastAPI → Next.js via Vercel AI SDK v6), LangGraph stateful multi-agent graphs, episodic memory via pgvector, MCP overview, and production failure modes with anti-pattern/fix code pairs.
agent-architect
Meta-agent that designs and orchestrates optimal agent swarms to build complex projects. Analyzes requirements, determines agent count, defines responsibilities, launches parallel agents, monitors progress, and integrates outputs into final deliverable.
agent-architect-reviewer
Expert architecture reviewer specializing in system design validation, architectural patterns, and technical decision assessment. Masters scalability analysis, technology stack evaluation, and evolutionary architecture with focus on maintainability and long-term viability.