guicedee/senior-architect
skills/.curated/senior-architect/SKILL.md
Senior software architecture workflows and tooling for system design, scalability and reliability planning, API/data modeling, trade-off analysis, ADR writing, and producing clear architecture diagrams (Mermaid). Use when you need to define or revise architecture for a feature/system, choose technologies, document decisions, or review an existing codebase’s architecture.
$ install --global
skillsauthnpx skillsauth add guicedee/ai-rules senior-architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 3:30 PM80.2s10 files scanned
SKILL.md
- name:
- senior-architect
- description:
- Senior software architecture workflows and tooling for system design, scalability and reliability planning, API/data modeling, trade-off analysis, ADR writing, and producing clear architecture diagrams (Mermaid). Use when you need to define or revise architecture for a feature/system, choose technologies, document decisions, or review an existing codebase’s architecture.
Senior Architect
Design and document architectures that are clear, defensible, and shippable.
Quick Start
- Clarify constraints:
- Primary user journey + success metrics
- Non-functional requirements (latency, throughput, availability, cost, compliance)
- Team constraints (skills, timelines, operational maturity)
- Produce outputs (in this order):
- Context: system boundary + external dependencies
- Containers: major runtime components and responsibilities
- Interfaces: APIs/events/contracts + data ownership
- Risks: failure modes + mitigations + open questions
- Decisions: ADRs with explicit trade-offs
Use the bundled tools (optional, but recommended)
From your project root, run the scripts from the installed skill directory (default install location: ~/.codex/skills/senior-architect/).
Bootstrap a documentation skeleton (ADR + architecture doc templates):
python ~/.codex/skills/senior-architect/scripts/project_architect.py . --out docs/architecture
Summarize dependencies and detected stack signals (Node/Python/Go/Rust, Next.js, Postgres, etc.):
python ~/.codex/skills/senior-architect/scripts/dependency_analyzer.py . --json --output /tmp/deps.json
Generate a starter Mermaid diagram based on detected components:
python ~/.codex/skills/senior-architect/scripts/architecture_diagram_generator.py . --out docs/architecture/diagram.mmd
References (load only when needed)
- Architecture patterns and when to use them:
references/architecture-patterns.md - End-to-end system design workflow + checklists:
references/system-design-workflow.md - Tech decision matrixes (DB, APIs, queues, caching, observability):
references/tech-decision-guide.md
Deliverables (what “done” looks like)
docs/architecture/ARCHITECTURE.mdwith clear boundaries, contracts, data ownership, and scaling assumptions- At least one ADR under
docs/architecture/adr/for the most consequential decision - A Mermaid diagram (
.mmd) that matches the written architecture
Related Skills
guicedee/skill-installer
development
VerifiedTrustedCommunity
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
5SKILL.mdUpdated Apr 5, 2026
guicedee/skill-creator
tools
VerifiedTrustedCommunity
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
5SKILL.mdUpdated Apr 5, 2026
guicedee/jwebmp-webawesome
development
VerifiedTrustedCommunity
WebAwesome icon integration for JWebMP — modern, open-source icon library. Provides 1,500+ icons with solid/regular styles, sizing, rotation, animation, and CSS utilities. Drop-in FontAwesome alternative with fresh designs. Use when working with WebAwesome icons, modern icon designs, or as FontAwesome alternative in JWebMP applications.
5SKILL.mdUpdated Apr 5, 2026
guicedee/jwebmp-webawesome-pro
development
VerifiedTrustedCommunity
WebAwesome Pro integration for JWebMP with premium icons and features. Extends jwebmp-webawesome with additional styles, premium icons, and advanced features. Use when working with WebAwesome Pro icons or premium WebAwesome features in JWebMP applications.
5SKILL.mdUpdated Apr 5, 2026