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-cli-herdr
tools
VerifiedTrustedCommunity
Delegate implementation to codex (coder) via the herdr-agentchat plugin and drive a two-pane conversation to completion.
11SKILL.mdUpdated Jul 27, 2026
thkt/scribe
development
VerifiedTrustedCommunity
Extract recurring patterns from past closed PRs/issues and the research findings in workspace/research/, verify them against the latest code, and propose them to docs/wiki/ via PR.
11SKILL.mdUpdated Jul 20, 2026
thkt/dr
development
VerifiedTrustedCommunity
Create Decision Records (DR) in MADR v4 format with auto-numbering.
11SKILL.mdUpdated Jul 15, 2026
thkt/polish
development
VerifiedTrustedCommunity
Codex review + cleanup. Findings are challenged by critic-audit, not aggregated as facts, and fixes are applied directly. Do NOT use for internal multi-reviewer deep audits or findings reports (use /audit).
11SKILL.mdUpdated Jul 14, 2026