Senior Architect

What it does

The first-fluke-senior-architect skill allows AI agents to design and document complex software architectures. It can generate detailed architectural diagrams, define component interactions, and produce comprehensive technical documentation suitable for engineering teams. This skill focuses on creating scalable and maintainable solutions based on best practices.

When to use it

• Designing a new microservice: Use the skill to outline the architecture of a new microservice, including its dependencies and APIs.
• Refactoring an existing system: Leverage the skill to analyze and document the current architecture, identifying areas for improvement and proposing refactoring strategies.
• Creating technical documentation: Generate clear and concise architectural diagrams and documentation for onboarding new team members or communicating with stakeholders.
• Evaluating technology choices: Ask the agent to assess different technologies based on their suitability for a specific architectural pattern.

Key capabilities

• Architectural diagram generation
• Component interaction definition
• Technical documentation creation
• Scalability and maintainability considerations
• Best practices implementation

Example prompts

• "Design an architecture for an e-commerce platform using microservices."
• "Document the existing architecture of our order processing system, including all components and their interactions."
• "Generate a sequence diagram illustrating how users authenticate with our application."

Tips & gotchas

The skill assumes a basic understanding of software architectural principles. Providing context about specific requirements or constraints will improve the quality of the generated output.