What are the prerequisites for using this skill?

The skill looks for a backlog.org file in your project root or a docs/design/ directory. If these aren't present, you may need to run /backlog:setup first.

How does this skill detect when a design doc is needed?

The skill monitors conversations for keywords like 'RFC', 'proposal', or 'architectural decision' and triggers when tradeoffs or significant feature changes are discussed.

Can I convert my existing Markdown documents?

Yes, the skill specifically supports converting existing .md files into Org-mode, extracting tasks, and assigning them unique project IDs automatically.

Why use Org-mode instead of Markdown for design docs?

Org-mode provides advanced task management features, better metadata handling (PROPERTIES), and a more rigid structure that helps AI agents track implementation progress.

Design Doc & RFC Architect

Name: Design Doc & RFC Architect
Author: farra

byfarra

•

协作工具

Facilitates the creation and conversion of structured design documents and RFCs using Emacs Org-mode for integrated task management.

This skill empowers developers to maintain high-quality technical documentation by proactively identifying when architectural decisions or new features require formal records. It orchestrates the creation of design documents and RFCs within an Org-mode based backlog system, allowing for a seamless transition from high-level planning to actionable tasks. Whether scaffolding a new proposal or converting legacy Markdown files into structured Org-mode, it ensures consistency in technical rationales, tradeoff analysis, and project task tracking, making it an essential tool for teams prioritizing long-term maintainability and clear communication.

主要功能

01Standardized RFC/RFD scaffolding using pre-defined project templates

0222 GitHub stars

03Automatic indexing of new documents within the centralized project backlog

04Proactive suggestions for documentation during architectural discussions

05Automated conversion of Markdown design docs to structured Org-mode

06Integrated task extraction with unique project IDs and status tracking

使用场景

01Migrating legacy Markdown documentation to a structured Org-mode task system

02Proposing significant architectural changes or complex new feature implementations

03Documenting technical tradeoffs and decision rationales for team review

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add farra/dev-agent-backlog new-design-doc

For use in Claude.ai and ChatGPT

Download Skill