architect

Detects repo type and populates architecture documentation templates from codebase analysis.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill architect-vickysrawat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/vickysrawat/AI-Assisted-development/tree/main/skills/architect
Command: npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill architect-vickysrawat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New or undocumented codebases lack architecture documentation, forcing developers to reverse-engineer system structure manually. This Skill detects the repository type, deploys matching architecture templates into .claude/architecture/, and populates only the missing files by analyzing the actual source code. ## Core Features & Use Cases - Stack Detection: Identifies repo type across .NET API, ASP.NET Framework/MVC, Angular (Nx/standard), React, JS libraries, Spring Boot, Python (Django/FastAPI/Flask), and VSTO add-ins. - Deployment Context Capture: Runs a gated questionnaire covering hosting, CI/CD, secrets, Entra ID authentication, and rollback, writing architecture-deployment.md only after explicit APPROVED confirmation. - Template Population: Composes an 8-file architecture set (overview, call chains/flows, reference, data, integrations, security, decisions) with Mermaid diagrams, filling every section from source files and marking unknowns with ⚠ markers instead of guessing. - Use Case: After cloning a legacy .NET Framework + Angular solution, run the architect skill to generate a complete architecture documentation set — including per-project runtime versions, middleware pipelines, and an Entra ID auth model — without writing any docs by hand. ## Quick Start Ask the AI to populate the architecture docs for this repository by analyzing the codebase and filling in the missing architecture files.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I generate architecture documentation for an existing codebase?

Run the architect skill, which detects your repo type, deploys matching templates into .claude/architecture/, and populates missing files by reading project files, controllers, and configuration. Every fact comes from source; undeterminable sections get a ⚠ needs-manual-input marker.

What tech stacks does automated architecture detection support?

Detection covers .NET Web API, ASP.NET Framework and MVC, Angular Nx and standard workspaces, React, JS/TS libraries, Spring Boot, Python Django/FastAPI/Flask, and VSTO add-ins. Each stack maps to a dedicated template folder and prompt set.

Does the architect skill write files without confirmation?

No. The deployment-context file (architecture-deployment.md) is written only after you review a full draft and reply with the exact word APPROVED. EDIT and REJECT options let you revise individual fields or restart the questionnaire.

How does the skill handle Entra ID authentication documentation?

It scans for MSAL, AzureAd, and JWT signals first, then asks targeted questions about tenant model, app registrations, token validation, scopes, and SPA token storage only when those signals exist. PKCE usage is always confirmed explicitly rather than assumed.

What happens when architecture details cannot be determined from code?

The skill never invents facts. Sections that cannot be derived from source files are marked with ⚠ Could not determine — needs manual input, and the decisions log is seeded with at most 3-5 entries with rationale left blank for humans.