Generate professional software diagram files for system structure, runtime flows, integrations, data, deployment, or security boundaries. Use only when the user asks for a diagram artifact.
Resources
1Install
npx skillscat add joaomj/pi-agent-config/architecture-diagram Install via the SkillsCat registry.
SKILL.md
Architecture Diagram
Create the smallest diagram that answers one explicit question for a known
audience.
- Inspect the repository evidence that defines participants, relationships,
protocols, state, and deployment. - Choose the view from the question:
- Context for users, the system, and external systems.
- Container or component for major runtime or logical boundaries.
- Sequence for one request, event, job, or integration scenario.
- Flow for a process or decision.
- State for lifecycle transitions.
- Data model for entities and relationships.
- Deployment for runtime nodes, networks, and trust boundaries.
- Include only elements needed to answer the question.
- Label every relationship with direction and behavior. Include protocol or
technology only when repository evidence supports it. - Show meaningful failure, retry, authorization, or asynchronous behavior when
it is part of the question. - Mark assumptions and unknowns. Do not invent participants or behavior.
- Read and follow
references/output-contract.mdbefore creating files.
For an inline visual response, answer directly in chat with a diagram. Do not create
files unless the user requested a diagram artifact.