thkt/creating-adrs
skills/creating-adrs/SKILL.md
Structured ADR creation in MADR format. Use when: ADR, Architecture Decision, 決定記録, 技術選定, アーキテクチャ決定, deprecation, 非推奨化.
$ install --global
skillsauthnpx skillsauth add thkt/claude-config creating-adrsInstall 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 20, 2026, 9:28 AM9.2s6 files scanned
SKILL.md
- name:
- creating-adrs
- description:
- >
- Structured ADR creation in MADR format. Use when:
- ADR, Architecture Decision,
- Bash(mkdir:
- *,
- user-invocable:
- false
ADR Creator
6-Phase Process
| Phase | Actions |
| ------------- | ------------------------------------------------------------------------ |
| 1. Pre-Check | Run ./scripts/pre-check.sh "$TITLE" (uses shared scripts) |
| 2. Template | Run $HOME/.claude/scripts/select-adr-template.sh "$TITLE" |
| 3. References | Gather project docs, issues, external resources |
| 4. Validate | Check required sections (Title, Status, Context, Decision, Consequences) |
| 5. Index | Auto-generate adr/README.md |
| 6. Recovery | Handle missing dirs, duplicates, missing sections |
Template Selection
Use script to auto-select template:
TEMPLATE=$("$HOME/.claude/scripts/select-adr-template.sh" "$TITLE")
| Template | Use Case | Required Sections | | -------------------- | -------------------------- | -------------------------- | | technology-selection | Library, framework choices | Options (min 3), Pros/Cons | | architecture-pattern | Structure, design policy | Context, Consequences | | process-change | Workflow, rule changes | Before/After comparison | | deprecation | Retiring technology | Migration plan, Timeline |
Directory Structure
adr/
├── README.md # Auto-generated index
├── 0001-*.md # Sequential numbering
└── 0002-*.md
Rules
| Rule | Detail |
| ------------ | ------------------------------------------------------------------------------------------- |
| Immutability | Once accepted, never modify. To change, create a new ADR that supersedes it |
| Brevity | Target ~80 lines. Context: 3 lines. Options: 3-5 lines each. Consequences: 2-3 bullets |
| Confidence | - Confidence: {level} — {rationale} in metadata. Level + reason in one line |
| Reassessment | Optional ## Reassessment Triggers section after Consequences |
Confidence Levels
| Level | When to use | | ------ | -------------------------------------------------------- | | high | All options evaluated, clear winner, team consensus | | medium | Some unknowns remain, limited production data | | low | Best guess under constraints, significant unknowns exist |
References
| Topic | Resource |
| --------- | ----------------------------- |
| MADR | https://adr.github.io/madr/ |
| Fowler | https://martinfowler.com/articles/architecture-decision-record.html |
| Skill | ../adr/SKILL.md |
| Templates | ../../templates/adr/ |
| Scripts | ./scripts/ |
Related Skills
thkt/use-workflow-plan-preview
tools
VerifiedTrustedCommunity
Internal helper for /think Step 11. Renders SOW.md + Spec.md as an integrated Astro view and returns a dev server URL.
9SKILL.mdUpdated Jun 1, 2026
thkt/probe
development
VerifiedTrustedCommunity
Extract repository spec while detecting bugs, spec gaps, and consistency drift via dual-purpose documentation. OUTCOME.md-axis question-driven exploration with ephemeral output. Do NOT use for code review (use /audit or /polish), feature implementation (use /code), planning only (use /think), or single-bug fix (use /fix).
9SKILL.mdUpdated Jun 1, 2026
thkt/audit-adr-gaps
development
VerifiedTrustedCommunity
Discover undocumented design decisions and challenge each candidate via critic-design before promotion. Rank by impact and reversibility, produce ADR promotion candidates. Treat each candidate as a position arguing for ADR status, not a fact to be filed. Pairs with audit-adr-drift, which scans existing ADRs for drift against code.
9SKILL.mdUpdated Jun 1, 2026
thkt/audit-adr-drift
development
VerifiedTrustedCommunity
Scan ADR Decision sections against current code and report drift with modification direction and priority. Do NOT use for repos without ADRs (use audit-adr-gaps instead).
9SKILL.mdUpdated Jun 1, 2026