frame-a-proposal

Drafts RFC-style design proposals in proposals/ with gated problem framing, alternatives, and drawbacks.

Updated Sep 7, 2026
One-click install
npx skills add https://github.com/jcafeitosa/anxionOS --skill frame-a-proposal-jcafeitosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frame-a-proposal
Source: https://github.com/jcafeitosa/anxionOS/tree/main/.cursor/skills/frame-a-proposal
Command: npx skills add https://github.com/jcafeitosa/anxionOS --skill frame-a-proposal-jcafeitosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design discussions often jump straight to solutions before anyone agrees on the problem, producing RFCs with strawman alternatives and empty drawbacks sections that reviewers cannot meaningfully evaluate. This Skill enforces a gated authoring workflow that frames the beneficiary, observable change, and forced decision before any design text is written. ## Core Features & Use Cases - Gated proposal authoring: A mandatory ten-step workflow (prior-art scan, problem framing STOP gate, sequence allocation, motivation, design, alternatives, drawbacks, unresolved questions, validation, recap) that blocks drafting the Design section before the problem is confirmed. - Template-based creation: Allocates the next zero-padded sequence number and creates the file from the proposal template with correct frontmatter (type, status: draft, authors, created, tags). - Review-quality enforcement: Requires at least two real alternatives with why-not rationale, honest drawbacks, and an unresolved-questions backlog where each entry names resolving evidence and a decider. - Use Case: An engineer wants to propose an async export pipeline. The Skill first scans proposals/ and decisions/ for prior art, confirms the framing (beneficiary, observable change, forced decision) with the user, then drafts proposals/0007-async-export-pipeline.md with all five required sections and validates links via audit. ## Quick Start Ask the agent to frame a design proposal for the change you have in mind, and confirm the beneficiary, observable change, and forced decision when it presents the framing gate.

Frequently Asked Questions about frame-a-proposal

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

FAQPage Schema
How do I write an RFC or design proposal with an AI agent?▼

Invoke the skill with the problem you want to propose. It scans existing proposals and decisions for prior art, then presents a framing (beneficiary, observable change, forced decision) for your confirmation before drafting the full RFC from the proposal template.

What sections does a design proposal need to be reviewable?▼

This workflow requires five sections: Motivation (problem, evidence, cost of doing nothing, non-goals), Design at an altitude reviewers can disagree with, at least two real Alternatives with why-not rationale, honest Drawbacks, and Unresolved questions each naming resolving evidence and a decider.

Does this skill require the OpenKnowledge MCP server?▼

Yes. All markdown operations go through the OpenKnowledge MCP server (exec, search, write, edit, links, audit) rather than native file tools. It is installed project-local via `ok seed --pack software-lifecycle`.

Can the agent mark a proposal as accepted or move it to fcp?▼

No. Advancing status from draft to fcp or accepted is explicitly a human act. The skill stops at a validated draft and recaps what advancing would require; acceptance graduates to a decision record via the separate record-a-decision skill.

When should I not use this proposal workflow?▼

Do not use it to record an already-accepted decision (use record-a-decision), to write an implementation spec (use write-a-spec), to write a postmortem, or to review an existing design. It only frames new proposals ending at draft status.