learn-ie-write

Create architecture decision records with context, alternatives, and consequences.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/novel-jp/projsight-plugin --skill learn-ie-write
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn-ie-write
Source: https://github.com/novel-jp/projsight-plugin/tree/main/skills/learn-ie-write
Command: npx skills add https://github.com/novel-jp/projsight-plugin --skill learn-ie-write

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn technical choices into clear decision records that explain the context, justify the decision, and make future tradeoffs easier to understand.

Core Features & Use Cases

  • Guides you through choosing a technical topic such as state management, API design, testing strategy, or database selection.
  • Prompts for the required DR sections: context, decision, alternatives, consequences, and constraints.
  • Encourages specific rejection reasons and balanced discussion of both positive and negative impacts.
  • Supports a review-and-improve loop so you can refine the DR after checking for missing alternatives or weak justification.

Quick Start

Ask me to help draft a DR for your chosen technical topic and then review it for missing alternatives, weak rejection reasons, and omitted downsides.

Frequently Asked Questions about learn-ie-write

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an architecture decision record for technical selection?

An architecture decision record for technical selection requires context, the final decision, at least two alternatives with rejection reasons, positive and negative consequences, explicit constraints, and a review loop to refine weak justifications.

What is tradeoff analysis in software engineering architecture decisions?

Tradeoff analysis in software engineering evaluates competing technical options by documenting their positive and negative consequences, ensuring project-specific constraints are balanced against alternatives before finalizing an architecture decision record.

How do I document alternatives and rejection reasons for database selection?

Documenting alternatives for database selection involves listing at least two options, providing specific rejection reasons for each, and noting the positive and negative consequences of the chosen approach within your project constraints.

Can I review my architecture decision record for missing alternatives?

Yes, you can review your architecture decision record through a review loop that checks for missing alternatives, weak rejection reasons, and omitted downsides, allowing you to refine and upsert the document for balanced tradeoff analysis.

When do I need an architecture decision record for API design?

You need an architecture decision record for API design when facing project-specific tradeoff decisions, ensuring your chosen approach documents context, alternatives, consequences, and constraints to make future technical impacts easier to understand.