the-agency-ai/.claude/skills/design
.claude/skills/design/SKILL.md
Drive toward a complete Architecture & Design (A&D) using 1B1 protocol with completeness checklist.
$ install --global
skillsauthnpx skillsauth add the-agency-ai/the-agency .claude/skills/designInstall 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 24, 2026, 8:57 PM2.2s1 file scanned
SKILL.md
- description:
- Drive toward a complete Architecture & Design (A&D) using 1B1 protocol with completeness checklist.
<!--
Flag #62/#63: allowed-tools removed. Inherits Bash(*) from
.claude/settings.json. Restricting to specific subcommand patterns at the
skill level silently blocks agents on permission prompts the agent cannot
see — see dispatch #171 for the devex incident that surfaced this trap.
-->
Design — A&D Completeness
Drive toward complete Architecture & Design (A&D) using the 1B1 protocol with a completeness checklist. Typically follows /define — the PVR informs architecture.
Usage
/design— start fresh, auto-detect project/design "Project Name"— start fresh for named project/design --from <pvr-file>— use PVR as input/design --continue <ad-file>— resume work on an existing A&D
Behavior
Step 1: Establish context
If --from specified, read the PVR. If --continue, read the existing A&D. If a PVR exists for this project, load it automatically.
Step 2: Scan for existing work
Glob claude/workstreams/*/ad-*.md for existing A&D files. If found, offer to continue.
Step 3: Build discussion agenda
Map the completeness checklist to discussion items. Skip items already covered.
Step 4: Start discussion
Invoke /discuss via the Skill tool, passing the agenda items.
Step 5: Update A&D progressively
After each item resolves, update the A&D file. Also update the PVR if design decisions reveal requirement changes.
A&D location: claude/workstreams/{workstream}/ad-{workstream}-{slug}-{YYYYMMDD}.md.
Step 6: Present completeness scorecard
A&D Completeness:
1. Architecture Overview ✓ Complete
2. Data Model ✓ Complete
3. Interfaces ✓ Complete
4. Dependencies ✓ Complete
5. Technology Choices ✓ Complete
6. Trade-offs ✓ Complete
7. Failure Modes ~ Partial
8. Security Considerations ✓ Complete
9. Deployment & Operations ✓ Complete
10. Open Technical Questions 1 remaining
Score: 9/10 complete
Completeness Checklist
- Architecture Overview — High-level system design, component relationships
- Data Model — Entities, relationships, storage strategy
- Interfaces — APIs, protocols, contracts between components
- Dependencies — External services, libraries, infrastructure
- Technology Choices — Languages, frameworks, databases, and why
- Trade-offs — What was considered and rejected, with reasoning
- Failure Modes — What can go wrong? How does the system degrade?
- Security Considerations — Auth, data protection, attack surface
- Deployment & Operations — How it runs, scales, is monitored
- Open Technical Questions — Unresolved technical items
Related Skills
the-agency-ai/src/claude/skills/worktree-sync
business
VerifiedTrustedCommunity
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-list
tools
VerifiedTrustedCommunity
List all git worktrees with status info (branch, clean/dirty, deps)
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-delete
tools
VerifiedTrustedCommunity
Remove a git worktree and optionally delete its branch
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-create
development
VerifiedTrustedCommunity
Create a new git worktree with dedicated branch and bootstrapped dev environment
5SKILL.mdUpdated Apr 22, 2026