discuss
discuss guides you through governance design conversations grounded in your repository's existing context. It helps identify constraints, compare design options, and produce durable artifacts like RFCs and ADRs that capture decisions and obligations without moving into implementation.
discuss explores governance design options and resolves ambiguity by drafting RFC or ADR artifacts without implementation.
AI-generated summary based on this skill's SKILL.md
Install
govctl-org/govctl/discuss · repository language: Rust
git clone https://github.com/govctl-org/govctl
cp -r govctl/.claude/skills/discuss ~/.claude/skills/discussnpx skillfed install govctl-org/govctl/discussFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is discuss and what governance tasks does it handle?
discuss is a governance design tool that guides you through structured conversations about architecture and policy decisions. It helps you explore RFC and ADR without coding, identify constraints from your repository's existing context, compare design options, and produce durable artifacts that capture decisions and obligations—all without moving into implementation.
How do I draft architecture decision records with discuss?
discuss supports drafting ADR and RFC documents by walking you through governance design exploration. It helps you analyze design trade-offs, establish decision rationale, and validate governance artifacts before lifecycle transitions. You can resolve design ambiguity governance by comparing options and documenting your reasoning without writing implementation code.
Can discuss help me explore design options and resolve ambiguity?
Yes. discuss is built to explore and discuss governance design options to resolve ambiguity at high priority. It grounds conversations in your repository's existing governance artifacts and constraints, then helps you analyze design trade-offs and establish clear decision rationale for each option you consider.
What kind of governance artifacts can discuss help me create?
discuss helps you draft RFC or ADR artifacts without implementing code. It supports governance artifact drafting, design rationale documentation, and governance design review processes. You can also validate governance artifacts before lifecycle transitions to ensure they meet your requirements.
Does discuss require me to write code or just discuss design?
discuss is purely a discussion and drafting tool—it produces durable artifacts like RFCs and ADRs that capture decisions and obligations without moving into implementation. You explore governance design options, compare trade-offs, and document rationale entirely through conversation and artifact creation, with no coding required.
SKILL.md
rendered from the published skill — quoted content, verbatim
Design Discussion
Understand $ARGUMENTS, relate it to existing governance, and produce only the
design artifacts justified by the discussion.
Operational Baseline
Discovery
Start from repository context rather than a blank design:
govctl status
govctl search <topic>
govctl rfc list
govctl adr list
Read relevant current artifacts with show; use --history only when prior
content matters. Use govctl <resource> --help for current authoring syntax. In
the govctl repository itself, invoke the development binary as
cargo run --quiet --.
Hard Stops
- This is a design workflow: do not implement code or create Work Items.
- Do not perform lifecycle or destructive artifact mutations here, including acceptance/rejection, phase or version changes, deprecation, supersession, and deletion.
- Do not issue raw VCS commands; use the
commitskill when drafts should be recorded. - RFCs own obligations, ADRs own design
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.claude/skills/discuss/SKILL.md