rakovi4/architecture
.claude/skills/architecture/SKILL.md
Facilitate architectural decisions during implementation. Use when the developer encounters a design choice with multiple viable approaches (data model, race condition handling, processing strategy, schema design) and needs structured discussion, trade-off analysis, and documentation. Triggers on /architecture or when a conversation reveals competing design options that need evaluation before coding continues.
$ install --global
skillsauthnpx skillsauth add rakovi4/continue-example architectureInstall 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 17, 2026, 1:19 AM8.5s1 file scanned
SKILL.md
- name:
- architecture
- description:
- Facilitate architectural decisions during implementation. Use when the developer encounters a design choice with multiple viable approaches (data model, race condition handling, processing strategy, schema design) and needs structured discussion, trade-off analysis, and documentation. Triggers on /architecture or when a conversation reveals competing design options that need evaluation before coding continues.
/architecture - Architectural Decision Record
Usage
/architecture 2 "task ordering within columns" # Story 2, named decision
/architecture 10 # Story 10, discover topic interactively
/architecture # Detect from recent git log
Purpose
When implementation reveals a design fork — multiple viable approaches with different trade-offs — this skill pauses coding to think through the options, document the decision, and plan the implementation with proper TDD steps.
Workflow
Phase 1: Context Gathering
- Resolve story from argument (same resolution as
/continue) - Read the story spec, current progress, relevant test specs, and existing ADRs
- Read the code involved — domain entities, usecases, adapters, schemas
- Summarize the decision point: what question needs answering, what triggered it, what constraints exist
Phase 2: Interactive Discussion
- Present the problem — describe the tension or fork point clearly
- Propose 2-4 options with trade-offs (how it works, pros/cons, impact, edge cases)
- Use AskUserQuestion to let the developer choose or propose alternatives
- Iterate until the approach is clear
- Draw diagrams when helpful — write HTML files to visualize complex flows
Phase 3: Write ADR
Use the format from .claude/templates/spec/adr-format.md.
Phase 4: Update Test Specs
Add edge case scenarios discovered during discussion to the appropriate test spec file.
Phase 5: Update Progress
Update progress.md with TDD steps that implement the decision.
Phase 6: Commit
Commit message: Story N: ADR for {decision topic} (Scenario X)
Rules
- Never generate code during this skill — it's a planning tool
- Always read existing ADRs in the story's
decisions/subfolder to avoid contradicting prior decisions - The developer makes the final call — present options, don't prescribe
- Keep ADRs concise — include current schema/code state when relevant
Templates
.claude/templates/spec/adr-format.md— ADR document format
Related Skills
rakovi4/test-usecase
testing
VerifiedTrustedCommunity
Run use-case module tests quickly. Use when user wants to run use-case tests or mentions /test-usecase command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-spec
development
VerifiedTrustedCommunity
Generate BDD test specifications for story in 6 categories (API, UI, Load, Infrastructure, Security, Integration). Use when user wants to create test cases or mentions /test-spec command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-review
testing
VerifiedTrustedCommunity
Review tests to replace loose validation (contains, isNotNull, isNotEmpty) with strict validation (isEqualTo on parsed fields). Use when user wants to improve test assertions or mentions /test-review command.
2SKILL.mdUpdated Apr 16, 2026
rakovi4/test-frontend
development
VerifiedTrustedCommunity
Run frontend tests. Use when user wants to run frontend unit tests or mentions /test-frontend command.
2SKILL.mdUpdated Apr 16, 2026