What is the primary output of this skill?

The skill produces a proposal.md file located within a structured change package directory, acting as the entry point for further design and planning.

What is the required naming convention for change packages?

It enforces a YYYYMMDD-HHMM-verb-description format, such as 20240116-1030-add-oauth2-support, to ensure chronological sorting and clear intent.

What is the 'Challenger' step in the process?

After drafting a proposal, the skill performs a self-scrutiny phase to check for missing constraints, edge cases, and architectural risks based on a completeness framework.

Does it integrate with other development workflows?

Yes, it is designed as the first step in a workflow that leads into impact analysis, design documentation, and eventually implementation and testing.

How does it handle ambiguous design choices?

It identifies design-level decisions and presents multiple options to the user for selection, ensuring humans remain in control of critical architectural paths.

DevBooks Proposal Author

Name: DevBooks Proposal Author
Author: Darkbluelr

byDarkbluelr

•

コラボレーションツール

Generates structured software change proposals to define the rationale, scope, and impact of technical decisions before implementation.

DevBooks Proposal Author is a specialized skill designed to create a Single Source of Truth (SSOT) for software changes. It automates the creation of proposal.md files, covering the 'Why', 'What', and 'Impact' of a change while facilitating 'Debate Packets' for architectural decisions. By enforcing strict naming conventions and presenting design options for user selection rather than making assumptions, it ensures that subsequent design, specification, and coding phases are built on a solid, reviewed foundation.

主な機能

01Structured proposal generation including Why/What/Impact and Debate Packets

02Context-aware detection of existing proposals and decision logs

03Interactive design decision-making with multi-option presentation

0476 GitHub stars

05Automated change package initialization with standardized naming conventions

06Built-in 'Challenger' review to identify risks, omissions, and uncertainties

ユースケース

01Documenting architectural decisions and their impact across modules

02Initializing a reliable workflow for large-scale AI-assisted development projects

03Drafting technical proposals for new features or complex system refactors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add darkbluelr/dev-playbooks-cn devbooks-proposal-author

For use in Claude.ai and ChatGPT

Download Skill