write-adr
Record a durable decision, including every new module, dependency, service or contract change.
Skill by sesigl
Chalk Labs
Need help deploying write-adr?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/sesigl-write-adr
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: documents, writing
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/write-adr
What's inside
- Skill name
write-adr- Description
- Record a durable decision, including every new module, dependency, service or contract change. Use before the change, not after.
- License
- Apache-2.0
- Instructions
- 12 lines in SKILL.md · view on GitHub
Files (1)
- SKILL.md
SKILL.md (first lines)
# Write an ADR 1. Copy `docs/decisions/_template.md` to `docs/decisions/NNNN-<short-name>.md` with the next number. 2. Fill in: context, decision, options considered, consequences. 3. Fill in **Prior art** for every new module, dependency or service: which existing projects you checked, their license and maintenance state, and why you adopt, extend or build. The DOCS check rejects an empty Prior art section. 4. Set `status: accepted` when the pull request makes the decision; its review is the approval. Use `proposed` only for a decision that stays open after the pull request. 5. Link the ADR from the module README and the pull request.
From sesigl/open-software-factory, Apache-2.0.
More from sesigl/open-software-factory
- 0.565score
implement-scenario
sesigl
Implement one planned scenario until its system test passes, then mark it implemented.
SkillAFreshness: AClaude Code +9 - 0.565score
fix-mutation-and-duplication
sesigl
Fix a MUTATION or DUP finding without unit tests or mocks.
SkillAFreshness: AClaude Code +9 - 0.564score
new-module
sesigl
Create a new module or adapter from the template.
SkillAFreshness: AClaude Code +9 - 0.561score
write-system-test
sesigl
Write the one system test that proves a Gherkin scenario from outside the module.
SkillAFreshness: AClaude Code +9 - 0.561score
write-scenario
sesigl
Write or change a Gherkin scenario for a module.
SkillAFreshness: AClaude Code +9 - 0.558score
keep-docs-evergreen
sesigl
Update documentation in the same change as the code.
SkillAFreshness: AClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 2
- Last commit (this folder)
- Oct 19, 2026 (13 days ago)
- Last release
- Oct 24, 2026 (8 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- Apache-2.0
- Repository
- github.com/sesigl/open-software-factory
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from sesigl
- 0.565score
implement-scenario
sesigl
Implement one planned scenario until its system test passes, then mark it implemented.
SkillAFreshness: AClaude Code +9 - 0.565score
fix-mutation-and-duplication
sesigl
Fix a MUTATION or DUP finding without unit tests or mocks.
SkillAFreshness: AClaude Code +9 - 0.564score
new-module
sesigl
Create a new module or adapter from the template.
SkillAFreshness: AClaude Code +9 - 0.561score
write-system-test
sesigl
Write the one system test that proves a Gherkin scenario from outside the module.
SkillAFreshness: AClaude Code +9 - 0.561score
write-scenario
sesigl
Write or change a Gherkin scenario for a module.
SkillAFreshness: AClaude Code +9 - 0.558score
keep-docs-evergreen
sesigl
Update documentation in the same change as the code.
SkillAFreshness: AClaude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get write-adr running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
write-adr skill. Agent Mart. https://agentmart.dev/skills/sesigl-write-adr (last updated 2026-10-24)