git404hub

what is principal-software-architect fr?

diogox451/principal-software-architect — explained in plain English

Analysis updated 2026-05-18

9ShellAudience · developerComplexity · 3/5LicenseSetup · easy

tl;dr

An installable AI agent skill that turns Claude Code, Codex, Cursor, or Grok into a senior software architect for reviews, ADRs, and design trade-offs.

vibe map

mindmap
  root((principal-software-architect))
    What it does
      Architecture reviews
      ADR generation
      Severity ranked findings
      Multi agent validation
    Tech stack
      Shell install script
      Claude Code
      Codex
      Cursor
      Grok
    Use cases
      Service split decisions
      Design pattern audits
      Team documentation
    Grounded in
      Clean Architecture
      Design Patterns
      Clean Code
      Microservices

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get an AI-generated architecture decision record for a hard-to-reverse system design choice.

VIBE 2

Have the AI run a severity-ranked review of your codebase's architecture against established patterns.

VIBE 3

Ask whether to split a service, backed by references to Clean Architecture, design patterns, and microservice best practices.

VIBE 4

Run a multi-agent validation where one agent proposes, another critiques, and a third synthesizes a final verdict.

what's the stack?

ShellClaude CodeCodexCursorGrok

how it stacks up fr

diogox451/principal-software-architecthwdsl2/docker-litellmdcarrero/awesome-code-review-prompts
Stars998
LanguageShellShellShell
Last pushed2026-07-09
MaintenanceActive
Setup difficultyeasymoderateeasy
Complexity3/53/5
Audiencedeveloperpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install with a single skills.sh command or clone and run the bundled install script.

Apache 2.0 license, use freely including commercially, with patent grant and attribution requirements.

in plain english

Principal Software Architect is an installable skill for AI coding assistants that makes the assistant behave like a senior software architect during conversations. It works with Claude Code, Codex, Cursor, OpenCode, Grok, and other agents that support the open Agent Skills format, and it can be installed through the skills.sh command line tool or by cloning the repository and running an install script. Once active, the skill asks the AI to think through constraints and existing patterns before suggesting a new structure, to compare design options by weighing the cost of reversing a decision, and to prefer extending the lowest existing layer of a codebase rather than introducing a brand new parallel framework. It can write architecture decision records for choices that are hard to undo, and it produces structured review output that flags issues by severity. The skill grounds its judgments in written summaries of several well known software books: Robert Martin's Clean Architecture, the Gang of Four's Design Patterns, Martin Fowler's writing on production ready microservices, Clean Code, and a book on algorithms called Entendendo Algoritmos. Each of these is distilled into short rule codes, for example CC for Clean Code rules or ALG for algorithm rules, so the AI can point to a specific standard when it flags a problem instead of giving vague advice. For each piece of code or architecture it looks at, the skill outputs a short structured line summarizing what was expected, what was actually observed, whether it fits established patterns, and what to do next. It can also run a multi agent check, where one agent proposes an assessment, a second agent argues against it, and a third agent produces a final synthesis before giving a verdict. Additional specialist checklists cover domain modeling, distributed data, API contracts, reliability, security, and how architecture decisions are documented and communicated to a team. The project is released under the Apache 2.0 license and includes both English and Brazilian Portuguese documentation. The package is meant to be installed once and then invoked either with a slash command or by describing the kind of review or decision you need in plain language.

prompts (copy fr)

prompt 1
Do an architecture review of the billing path using the principal-software-architect skill.
prompt 2
Write an ADR for switching our messaging bus to Kafka.
prompt 3
Multi-agent validate this proposed service split with PRIMARY, ADVERSARY, and SYNTH agents.
prompt 4
Audit this module against Clean Architecture and Clean Code standards.
prompt 5
Should we split this monolith service into two? Give me a baseline assessment.

Frequently asked questions

what is principal-software-architect fr?

An installable AI agent skill that turns Claude Code, Codex, Cursor, or Grok into a senior software architect for reviews, ADRs, and design trade-offs.

What language is principal-software-architect written in?

Mainly Shell. The stack also includes Shell, Claude Code, Codex.

What license does principal-software-architect use?

Apache 2.0 license, use freely including commercially, with patent grant and attribution requirements.

How hard is principal-software-architect to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is principal-software-architect for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.