skills.rest
govctl-org
govctl-orgOFFICIAL
Explore all skills by this author →
GitHub

discuss

Facilitate design discussions and draft RFC or ADR artifacts.

239|12|Updated Jan 17, 2026
Search Tags:#design#documentation#specification#adr#governance#rfc
One-click install
npx skills add https://github.com/govctl-org/govctl --skill discuss-govctl-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discuss
Source: https://github.com/govctl-org/govctl/tree/main/.claude/skills/discuss
Command: npx skills add https://github.com/govctl-org/govctl --skill discuss-govctl-org

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the initial design and specification phase of software development by facilitating focused discussions, researching existing context, and drafting formal documentation like Request for Comments (RFCs) and Architecture Decision Records (ADRs).

Core Features & Use Cases

  • Context Discovery: Automatically surveys existing governance artifacts (RFCs, ADRs) and project configurations to inform design decisions.
  • Artifact Drafting: Guides the creation of new RFCs and ADRs, or amendments to existing ones, ensuring adherence to project standards.
  • Use Case: When a new feature is proposed, this Skill helps the team understand the problem space, research relevant past decisions, and draft a clear RFC outlining the proposed solution before any code is written.

Quick Start

Discuss how to implement a new caching strategy for the project.

Frequently Asked Questions about discuss

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

FAQPage Schema
What is the best way to draft an RFC for a new software feature?▼

An Architecture Decision Record documents important architectural choices and their context. This Skill guides you through exploring design options and documenting decisions according to established project conventions to create a formal ADR.

How do I document architectural decisions for my project?▼

Documenting architectural decisions requires capturing the problem space, explored options, and final choice. This Skill researches existing project configurations and past artifacts to inform and draft a formal ADR adhering to your standards.

When do I need to create an ADR instead of a standard specification?▼

You need an ADR when making a significant architectural choice that requires formal governance documentation. This Skill helps classify whether your topic warrants an ADR or an RFC and structures the discussion accordingly.

Can I amend existing RFCs and ADRs when requirements change?▼

Amending existing RFCs and ADRs is supported to reflect updated requirements. The Skill surveys current governance artifacts and project configurations to guide the creation of amendments while ensuring adherence to established conventions.

Does this approach require existing governance artifacts to function?▼

No, existing governance artifacts are not strictly required, though they provide valuable context. The Skill automatically surveys available RFCs, ADRs, and project configurations to inform new design decisions, but can also draft initial specifications.

Related Skills

Explore More Software Engineering Skills→
govctl-orggovctl-org
239

migrate

Discovers implicit architectural decisions and specifications, converting them into ADRs and RFCs for govctl governance.

Official
Advanced
deichworxdeichworx

rfc

Author structured RFCs documenting architectural decisions with frontmatter and alternatives.

Community
Basic
ClawStackStudiosClawStackStudios

Blueprint Weaver Meta-Skill

Coordinate agents to scan codebases and update architectural documentation.

Community
Intermediate
MomoChenisMeMomoChenisMe
1

speclink-discuss

Initiate and record focused discussions as Markdown documents within Speclink.

Community
Advanced