andretauan/tao-architecture-decision
skills/en/tao-architecture-decision/SKILL.md
Architecture Decision Record (ADR) writing with trade-off analysis matrix and decision evaluation framework. Use when making architectural decisions, choosing technologies, or documenting design decisions.
$ install --global
skillsauthnpx skillsauth add andretauan/tao tao-architecture-decisionInstall 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 23, 2026, 2:28 PM195.5s1 file scanned
SKILL.md
- name:
- tao-architecture-decision
- description:
- Architecture Decision Record (ADR) writing with trade-off analysis matrix and decision evaluation framework. Use when making architectural decisions, choosing technologies, or documenting design decisions.
- user-invocable:
- false
TAO Architecture Decision Records
When to use
Use when making technology choices, designing system architecture, or evaluating design alternatives.
ADR Template
# ADR-NNN — [Decision Title]
**Date:** YYYY-MM-DD
**Status:** PROPOSED | ACCEPTED | DEPRECATED | SUPERSEDED by ADR-XXX
**Deciders:** [who was involved]
## Context
[What is the issue? What forces are at play?]
## Options Considered
### Option A — [Name]
- **Pros:** ...
- **Cons:** ...
- **Cost:** ...
### Option B — [Name]
- **Pros:** ...
- **Cons:** ...
- **Cost:** ...
## Decision
[Which option was chosen and WHY]
## Consequences
### Positive
- ...
### Negative
- ...
### Risks
- ...
Trade-Off Analysis Matrix
Score each option 1-5 on weighted criteria:
| Criteria | Weight | Option A | Option B | Option C | |----------|--------|----------|----------|----------| | Performance | 3 | 4 (12) | 3 (9) | 5 (15) | | Maintainability | 4 | 5 (20) | 3 (12) | 2 (8) | | Team expertise | 2 | 3 (6) | 5 (10) | 1 (2) | | Cost | 3 | 4 (12) | 3 (9) | 2 (6) | | Total | | 50 | 40 | 31 |
Decision Evaluation Criteria
Before accepting a decision, verify:
- [ ] At least 2 alternatives were evaluated
- [ ] Trade-offs are explicit and quantified
- [ ] Reversibility is assessed (one-way door vs two-way door)
- [ ] Team capability is considered
- [ ] Migration/adoption cost is estimated
- [ ] Decision is documented in a searchable format
Architecture Review Questions
- Does this scale to 10x current load?
- What happens when this component fails?
- Can we replace this component without rewriting?
- How do we monitor and debug this in production?
- What's the cost at scale? (compute, storage, licenses)
Related Skills
andretauan/tao-test-strategy
testing
VerifiedTrustedCommunity
Estratégia de pirâmide de testes com análise de cobertura, identificação de edge cases e planejamento de testes. Use ao planejar testes, melhorar cobertura, identificar edge cases ou escrever especificações de teste.
18SKILL.mdUpdated Apr 23, 2026
andretauan/tao-security-audit
development
VerifiedTrustedCommunity
Auditoria de segurança alinhada ao OWASP Top 10 com checklist para injection, XSS, autenticação, autorização, gestão de secrets e vulnerabilidades comuns. Use ao auditar segurança, revisar código de auth ou hardening de aplicação.
18SKILL.mdUpdated Apr 23, 2026
andretauan/tao-refactoring
development
VerifiedTrustedCommunity
Metodologia de refatoração segura com detecção de code smells, transformação passo-a-passo e prevenção de regressão. Use ao refatorar código, reduzir dívida técnica ou melhorar estrutura.
18SKILL.mdUpdated Apr 23, 2026
andretauan/tao-plan-writing
testing
VerifiedTrustedCommunity
Decomposição expert de tarefas para criar PLAN.md no TAO. Quebra features em fases e tarefas com critérios de aceite, estimativas e dependências. Use ao planejar trabalho, criar fases ou decompor features.
18SKILL.mdUpdated Apr 23, 2026