본문으로 건너뛰기
cccskills
무료GitHub에 공개

decision-record

Write an architecture decision record, a document explaining a team's design choice. Capture the context, rejected alternatives, and future costs so newcomers can understand the reasoning, then review the draft before saving it.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

Writes an architecture decision record (ADR). Use when the user says "record this decision", "write an ADR" or "we decided X, capture it".

설치 방법 보기

이럴 때 유용합니다

  • Recording an agreed architecture decision
  • Preserving reasons for rejecting alternatives
  • Explaining past design choices to new team members

포함된 파일(1)

  • SKILL.md1.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Decision record

You turn a decision the team has reached into a record a newcomer can read a year later and understand why the system is the way it is. That reader was not in the room, so the record names the forces, not just the outcome.

On activation

  1. Config: uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.output_folder --key core.active_initiative. Script not found: BMad is not set up here; offer the bmad skill's setup, installing bmad first if needed (npx skills add bmad-code-org/BMAD-METHOD --skill bmad), then run it again.
  2. The record lands at {output_folder}/{active_initiative}/adr-{slug}/adr-{slug}.md, dropping /{active_initiative} when unset. {slug} is the decision in kebab-case.

Writing the record

Mine the conversation first: the decision, the options and the reasons are usually already there. Ask only for what is missing, one question at a time: what was decided, what else was considered and why it lost, what this makes harder later.

Write four sections: Context, Decision, Options considered, Consequences. Each option gets one line on why it lost. A consequence is something that will cost effort or close a door, not a benefit restated.

Show the draft and wait. On approval, write the file and tell the user the path.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

bmad

무료

Get guidance on using installed BMad modules and choosing the next skill for a task. The skill also handles installation setup, updates, repairs, module additions, artifact migration, and selecting the active initiative being worked on.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Choosing where to start or what to do next
  • Setting up or repairing a BMad installation
  • Adding modules or migrating project artifacts
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

Revisit a recent answer, plan, draft, or decision using selected critique methods. The skill offers relevant approaches, explains what they reveal, and proposes improvements that are applied only after the user accepts them.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Examining assumptions in a plan
  • Reviewing a draft from several perspectives
  • Exploring failure risks before a launch
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

Work with Mary, a business analyst persona, to research markets, examine competitors, and clarify requirements. Use evidence-based discussion to turn vague needs into concrete specifications that can guide the next steps of a project.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Researching a market before planning a project
  • Examining competitors to inform a business idea
  • Turning vague requests into concrete requirements
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

Turn product requirements and user experience plans into technical architecture with Winston, a system architect persona. Discuss technology choices and their trade-offs, with an emphasis on established tools, developer productivity, and designs that can be implemented.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Turning product requirements into a technical design
  • Discussing trade-offs between technology choices
  • Reviewing architecture with developer productivity in mind
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

Implement approved development stories and code changes with Amelia, a senior software engineer persona. Follow a test-first process: write a failing test, make it pass, then improve the code while checking every acceptance criterion.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Implementing an approved development story
  • Making code changes with a test-first process
  • Checking implementation against acceptance criteria
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

Work with John, a product manager persona, to clarify requirements through user interviews and stakeholder alignment. Turn a product vision into a PRD, a product requirements document, and small, validated increments for development.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Turning a product idea into a PRD
  • Discovering requirements through user interviews
  • Aligning stakeholders on product requirements
bmad-code-org/BMAD-METHOD5.4만2026년 10월 19일 업데이트

bmad-code-org의 스킬 모두 보기

이 스킬의 문제 신고