architect

Draft technical specifications covering architecture, APIs, data models, and migrations.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/micaelmalta/agentic --skill architect-micaelmalta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/micaelmalta/agentic/tree/main/skills/architect
Command: npx skills add https://github.com/micaelmalta/agentic --skill architect-micaelmalta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams draft rigorous and shared technical specifications before implementing features. It clarifies goals, scope, architecture, and rollout plans, reducing ambiguity and rework across stakeholders.

Core Features & Use Cases

  • Structured Tech Proposals: Follow the Tech Proposal Template to capture metadata, architecture considerations, data models, API changes, and risks.
  • Migration & Rollout Planning: Includes a Database Migration Plan and rollout strategy to minimize disruption.
  • Aligned Implementation: Serves as the single reference for scope, interfaces, and success criteria across teams.

Quick Start

Start by drafting a tech spec for your feature using the architect skill: /architect. Then populate the Tech Proposal Template with sections such as metadata, architecture, data models, and migrations. When schema changes are involved, add a Database Migration Plan and outline rollout steps in the document.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I draft a technical specification for software architecture and APIs?

Draft a technical specification by structuring goals, scope, architecture, APIs, data models, and rollout strategies into a shared document. This reduces ambiguity and rework across engineering stakeholders before implementation begins.

What should a comprehensive tech proposal include for database migration planning?

A comprehensive tech proposal includes a Database Migration Plan and a Feature Flag Plan when applicable. These components outline schema changes and rollout steps to minimize disruption during deployment.

How do I document risk management and rollout strategies in a design document?

Document risk management and rollout strategies by capturing metadata, architecture considerations, and potential risks within the Tech Proposal Template. This structured approach ensures aligned implementation and clear success criteria.

When do I need to add a feature flag plan to my architecture tech spec?

You need a feature flag plan when your architecture tech spec involves phased rollout strategies or incremental delivery. Including it minimizes deployment disruption and provides clear scope boundaries for stakeholders.

Does this tech spec approach work for defining data models and API changes together?

Yes, this tech spec approach works for defining data models and API changes together. The Tech Proposal Template explicitly captures both elements, ensuring interfaces and schema modifications are aligned across teams.