Skip to content
cccskills
FreePublished on GitHub

adr-writer

Generate Architecture Decision Records with AI. Use when documenting technical decisions.

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

See how to install

Files included (7)

  • SKILL.md2.6 KB
  • package-lock.json31.0 KB
  • package.json592 B
  • README.md330 B
  • src/cli.ts686 B
  • src/index.ts1.0 KB
  • tsconfig.json264 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

ADR Writer

Writing Architecture Decision Records is one of those things everyone knows they should do but nobody actually does. Too much boilerplate, too much thinking about format when you should be thinking about the decision itself. This tool fixes that.

One command. Zero config. Just works.

Quick Start

npx ai-adr "switch from REST to GraphQL"

What It Does

  • Generates complete ADRs in standard format (title, context, decision, consequences)
  • Handles the boring structure so you focus on the actual decision
  • Creates consistent documentation your team can actually reference later
  • Works with any architectural decision from database choices to framework migrations

Usage Examples

# Database decision
npx ai-adr "use PostgreSQL over MongoDB for transactional data"

# Architecture pattern
npx ai-adr "adopt microservices instead of monolith"

# Framework choice
npx ai-adr "migrate from Express to Fastify"

# Infrastructure
npx ai-adr "move to Kubernetes from Docker Compose"

Best Practices

  • Be specific - "switch to GraphQL for mobile clients" beats "change API"
  • Include context - mention why you're making this decision in your description
  • Review the output - AI gets you 80% there, but add your team's specific context
  • Keep them versioned - commit ADRs alongside the code they document

When to Use This

  • Starting a new project and need to document initial tech choices
  • Making a significant architectural change that future devs will question
  • Onboarding new team members who need to understand past decisions
  • Satisfying compliance requirements for decision documentation

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

npx ai-adr --help

How It Works

Takes your plain English description of an architectural decision, sends it to GPT-4o-mini with a prompt optimized for ADR format, and returns a complete, well-structured document. The output follows the standard ADR template used by most engineering teams.

License

MIT. Free forever. Use it however you want.

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

name: 4d-compression-core version: 1.0.2 description: "把长内容压缩成结构化向量——节省 60-80% Token,保留核心信息" metadata: { "openclaw": { "emoji": "🌀", "requires": { "bins": ["jq", "awk"] }, "triggers": ["压缩", "4d",...

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

modbender/skill-library-mcp17Updated Sep 28, 2026

Use cheap, TEE-verified AI models from the 0G Compute Network as OpenClaw providers. Discover available models and compare pricing vs OpenRouter, verify provider integrity via hardware attestation (Intel TDX), manage your 0G wallet and sub-accounts, and configure models in OpenClaw with one workflow. Supports DeepSeek, GLM-5, Qwen, and other models available on the 0G marketplace.

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

modbender/skill-library-mcp17Updated Sep 28, 2026

Send and receive P2P messages using disposable numbers and PINs. No servers, no accounts. Use for human notifications, approval flows, and agent-to-agent communication.

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

modbender/skill-library-mcp17Updated Sep 28, 2026

Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3. Covers orderbooks, trades, candles, funding rates, open interest, liquidations, and data quality. Use when the user asks about crypto market data, orderbooks, trades, funding rates, or historical prices on Hyperliquid, Lighter.xyz, or HIP-3.

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

modbender/skill-library-mcp17Updated Sep 28, 2026

0xwork

Free

Find and complete paid tasks on the 0xWork decentralized marketplace (Base chain, USDC escrow). Use when: the agent wants to earn money/USDC by doing work, discover available tasks, claim a bounty, submit deliverables, check earnings or wallet balance, or set up as a 0xWork worker. Task categories: Writing, Research, Social, Creative, Code, Data. NOT for: posting tasks (use the website), managing the 0xWork platform, or frontend development.

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

modbender/skill-library-mcp17Updated Sep 28, 2026

Patterns and practices that dramatically accelerate development velocity. Covers parallel execution, automation, feedback loops, workflow optimization, and anti-pattern avoidance. Use when starting projects, planning sprints, optimizing workflows, or onboarding developers.

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

modbender/skill-library-mcp17Updated Sep 28, 2026

See all skills by modbender

Report a problem with this skill