akiojin/gwt-spec-analyze
plugins/gwt/skills/gwt-spec-analyze/SKILL.md
Analyze a `gwt-spec` artifact set for completeness and consistency across `spec.md`, `plan.md`, `tasks.md`, and supporting artifacts. Detect missing traceability, unresolved clarifications, and constitution gaps before implementation, and distinguish auto-fixable gaps from true decision blockers.
$ install --global
skillsauthnpx skillsauth add akiojin/gwt gwt-spec-analyzeInstall 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 2, 2026, 3:52 PM58.4s1 file scanned
SKILL.md
- name:
- gwt-spec-analyze
- description:
- Analyze a `gwt-spec` artifact set for completeness and consistency across `spec.md`, `plan.md`, `tasks.md`, and supporting artifacts. Detect missing traceability, unresolved clarifications, and constitution gaps before implementation, and distinguish auto-fixable gaps from true decision blockers.
gwt SPEC Analyze
Use this skill as the final gate before implementation starts.
gwt-spec-analyzeis still non-implementation work.- Do not implement code here.
- If artifacts are missing, distinguish between gaps that
gwt-spec-opscan repair automatically and gaps that truly require user input.
Required artifact set
doc:spec.mddoc:plan.mddoc:tasks.mdmemory/constitution.md
Optional but validated when present:
doc:research.mddoc:data-model.mddoc:quickstart.mdcontract:*
Mandatory checks
-
Clarification completeness
- No critical
[NEEDS CLARIFICATION]markers remain
- No critical
-
Spec completeness
- User Stories, Acceptance Scenarios, Edge Cases, Requirements, and Success Criteria exist
-
Plan completeness
Constitution CheckexistsTechnical ContextandPhased Implementationare concrete
-
Task traceability
- Every user story has tasks
- Every acceptance scenario has verification coverage
- Every contract/data-model change has matching tasks
-
Constitution alignment
- Violations are either removed or explicitly tracked in
Complexity Tracking
- Violations are either removed or explicitly tracked in
Required output
## Analysis Report: #<number>
Status: CLEAR | AUTO-FIXABLE | NEEDS-DECISION
Blocking items:
- A1. <artifact gap>
- A2. <traceability gap>
Next:
- `gwt-spec-ops`
- `gwt-spec-implement`
- ask user for decision
Decision rule
CLEAR: implementation may proceed throughgwt-spec-implementAUTO-FIXABLE:gwt-spec-opsshould repair the artifact set and rerun analysisNEEDS-DECISION: the report must point to the exact user decision or unresolved ambiguity
Operations
python3 "${CLAUDE_PLUGIN_ROOT}/skills/gwt-spec-ops/scripts/spec_artifact.py" \
--repo "." \
--issue "<number>" \
--list
Related Skills
akiojin/tui-design
tools
VerifiedTrustedCommunity
Create distinctive, production-grade terminal user interfaces. Use when building TUI components with ratatui, CLI output styling, or xterm.js terminal rendering. Triggers: 'design TUI', 'terminal UI', 'TUIデザイン', 'ターミナルUI', 'ratatui widget'
3SKILL.mdUpdated Apr 15, 2026
akiojin/gwt-spec-search
testing
VerifiedTrustedCommunity
Semantic search over SPEC Issues (GitHub Issue cache at ~/.gwt/cache/issues/) using vector embeddings. Use when searching for existing specs, finding related specs, checking for duplicate specs, or determining which spec owns a scope. Mandatory preflight before gwt-discussion when the work may need a SPEC owner. Use when user says 'search specs', 'find related specs', 'check for duplicate specs', or asks which spec owns a scope.
3SKILL.mdUpdated Apr 15, 2026
akiojin/gwt-search
testing
VerifiedTrustedCommunity
Mandatory preflight before gwt-discussion, gwt-register-issue, and gwt-fix-issue. Use proactively before creating any SPEC or Issue owner or before reusing an existing one. Searches SPEC Issues, GitHub Issues, and project files via ChromaDB. Triggers: 'search', 'find related', 'check duplicates'.
3SKILL.mdUpdated Apr 15, 2026
akiojin/gwt-register-issue
business
VerifiedTrustedCommunity
Use when the user wants to register new work from a bug report, idea, or task description and an existing GitHub Issue number is not already known.
3SKILL.mdUpdated Apr 15, 2026