skills.rest
vadimcomanescu
vadimcomanescuCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

senior-architect

Generate Mermaid diagrams and ADR templates from project dependency analysis.

24|8|Updated Jan 14, 2026
Search Tags:#architecture#scalability#mermaid#adr#diagrams#system-design#dependency-analysis
One-click install
npx skills add https://github.com/vadimcomanescu/codex-skills --skill senior-architect-vadimcomanescu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/vadimcomanescu/codex-skills/tree/main/skills/.curated/platform/senior-architect
Command: npx skills add https://github.com/vadimcomanescu/codex-skills --skill senior-architect-vadimcomanescu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Provides structured workflows and lightweight tooling to rapidly design, document, and defend system architectures so teams can make trade-offs, reduce risk, and produce shippable architecture artifacts.

Core Features & Use Cases

  • Architecture scaffolding: Bootstraps ARCHITECTURE.md and ADR templates to make decisions explicit and version-controlled.
  • Dependency and stack analysis: Scans project manifests to detect stack signals (Next.js, Node, Postgres, Redis, Python) to inform diagrams and assumptions.
  • Diagram generation: Produces starter Mermaid context/container diagrams reflecting detected components and integrations.
  • Deliverables: Clear system boundaries, container responsibilities, API/contracts, failure modes and mitigations, and at least one ADR for key decisions.
  • Use Case: Ideal for preparing design docs for a new feature, reviewing an existing codebase for architectural gaps, or choosing technology with documented trade-offs.

Quick Start

Run the skill's bootstrap and analysis tools from your project root to generate an initial ARCHITECTURE.md, ADR template, and a Mermaid context diagram.

Frequently Asked Questions about senior-architect

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

FAQPage Schema
How do I generate Mermaid diagrams for system architecture from my existing codebase?▼

Generating Mermaid architecture diagrams is done by scanning your project manifests to detect stack signals like Next.js, Postgres, or Redis, then automatically producing context and container diagrams reflecting those components and integrations.

What is an ADR template and when do I need one for system design?▼

An ADR template documents architectural decisions with explicit trade-offs. You need ADRs when choosing technologies or defining system boundaries, ensuring decisions are version-controlled, defensible, and reduce project risk.

How do I document system boundaries and API contracts for scalable web services?▼

Document system boundaries and API contracts by bootstrapping an ARCHITECTURE.md file that defines container responsibilities, failure modes, mitigations, and pragmatic trade-off analysis for latency, availability, and data ownership decisions.

Can I analyze project dependencies to detect my tech stack for architecture reviews?▼

Yes, you can analyze project dependencies by scanning manifests to detect stack signals across frameworks like Next.js, Node, Postgres, Redis, and Python to inform architecture diagrams and validate assumptions during codebase reviews.

What's the best way to defend system architecture trade-offs for latency and availability?▼

Defend architecture trade-offs by authoring ADRs that document pragmatic analysis for latency, availability, and data ownership decisions, making trade-offs explicit and version-controlled to reduce risk and produce shippable architecture artifacts.

Related Skills

Explore More Software Engineering Skills→
peopledearpeopledear
1

Global Tech Stack

Enforce global tech stack standards across code files, build scripts, and project configurations.

Official
Basic
vukhanhtruongvukhanhtruong
9

architecture-design

Generate ARCHITECTURE.md documentation with diagrams and OpenAPI specs.

Community
Advanced
m19803261706m19803261706

cx-exec

Execute development tasks and validate code against API contracts.

Community
Advanced
AlteriomAlteriom

architecture-designer

Design system architectures using C4 modeling, ADRs, and NFR analysis.

Official
Advanced