Skip to content
cccskills
FreePublished on GitHub

adr

Create a new Architecture Decision Record (ADR) for a proposed feature or design change.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Create ADR

Create a new ADR document for: $ARGUMENTS

Process

  1. Determine next ADR number: List docs/ai/adr/ to find the highest existing number, then increment by 1.

  2. Research the topic: Before writing, explore the codebase to understand the current state of the relevant area. Read related files, check existing ADR documents for context, and identify what currently exists vs what's missing.

  3. Write the ADR at docs/ai/adr/{NNN}-{slug}.md using this format:

# ADR {NNN}: {Title}

## Status: Proposed

## Context

{Why is this needed? What's the current situation? What problems exist?}

## Decision

{The proposed design. Include:}
- Architecture / structure
- UI layout (ASCII diagrams if helpful)
- State management approach
- Implementation details
- Mobile considerations

## Considerations

{Trade-offs, open questions, alternative approaches considered}

## Future Extensions

{What could be built on top of this later}

Guidelines

  • Write in English (per CLAUDE.md conventions). Discussion in Japanese is fine, but the ADR document itself should be in English
  • Include ASCII layout diagrams for UI-related ADRs
  • Reference specific files and line numbers for current code
  • Break complex features into phased implementation steps
  • Keep it concise but thorough enough to guide implementation

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Mark an ADR as Implemented (or Superseded) and archive it, following INDEX.md conventions.

The English summary is being prepared. Showing the original description.

im9/inboil2Updated Oct 17, 2026

Scan the codebase for security vulnerabilities. Check OWASP top 10, input validation, auth, crypto, and known BACKLOG security items.

The English summary is being prepared. Showing the original description.

im9/inboil2Updated Oct 17, 2026

Check docs/ai/ spec files and ADRs for inconsistencies with the actual codebase. Report only, no modifications.

The English summary is being prepared. Showing the original description.

im9/inboil2Updated Oct 17, 2026

Scan the project for refactoring opportunities, then fix them. No behavior/visual changes.

The English summary is being prepared. Showing the original description.

im9/inboil2Updated Oct 17, 2026

Check docs/ai/ spec files and ADRs for inconsistencies with the codebase, then fix all discrepancies.

The English summary is being prepared. Showing the original description.

im9/inboil2Updated Oct 17, 2026

See all skills by im9

Report a problem with this skill