discuss

A guided discussion process for exploring a new feature idea before deciding whether to discard it, save it for later, or prepare it for development.

In plain words
What is it for?
Brainstorming new features, revisiting parked ideas, comparing them with roadmap items, and recording the decision and supporting notes.
Why use it?
It prevents ideas from moving into implementation before their purpose, fit, and unresolved questions are clear.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/swingerman/engineer/discuss
Any agent
npx skills add swingerman/engineer --skill discuss
Clone the repo
git clone --depth 1 https://github.com/swingerman/engineer

Made for: Claude Code, Codex.

Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,223 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00054 $0.01223
Opus 5 $0.00027 $0.00611
Sonnet 5 $0.00011 $0.00245
Haiku 4.5 $0.00005 $0.00122

Measured 2d ago against content hash 3ca0625c1d09, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

discuss scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

engineer/skills/discuss/SKILL.md · 43 lines

How it starts

The opening of the file, as written. The whole thing — 43 lines — stays where its author put it; the contents beside it link to each section on GitHub.

discuss

The upstream funnel of DAE — a divergent brainstorm (forked from superpowers:brainstorming) that ends in one of three outcomes: drop, park, or promote. Most ideas die here; some park as features/NNN-slug/ with status: parked; survivors promote to status: ready.

When to use

  • Fresh/engineer.discuss, no argument. New exploration.
  • Continue/engineer.discuss <slug>. Resume a parked feature.

Not for: feature-work prep on an already-Ready feature (prime-context), or editing a committed feature (feature-edit).

Workflow

  1. Resolve + load — resolve the methodology root + manifest via ${CLAUDE_PLUGIN_ROOT}/scripts/dae_resolve.py (see references/resolving.md). Load CHARTER.md and the last ~20 lines of .engineer/discussions.log. With a slug arg: also load that feature's feature.md + prior handoffs/*-discuss.md; reject if its status is ready/in-progress (→ feature-edit) or done.
  2. Open — fresh: "What are you thinking about?" After the first prompt, soft-match the topic against parked feature titles/areas and against roadmap items (driver per references/roadmap.md; local = ${CLAUDE_PLUGIN_ROOT}/scripts/dae_roadmap.py list); if it matches a planned roadmap item, say so and offer to promote that item (carry its id as roadmap_ref) rather than starting a disconnected idea. Continue mode: echo prior state in one line, then resume.
  3. Brainstorm (divergent) — explore intent, scope, alternatives; one question per turn. Surface charter signals (e.g. payment paths cap autonomy), ADR connections, and "too big — decompose?" flags as they arise.
  4. Surface the outcome — at a natural inflection, recommend an outcome (promote / prototype / park / drop); the user confirms. Never auto-execute. If the user says "drop" but there's a concrete reason it's worth parking, ask once. When the idea is fuzzy, UX-heavy, or "I'll know it when I see it" — better answered by building than by talking — recommend the prototype path (${CLAUDE_PLUGIN_ROOT}/references/two-paths.md): iterate a rough artifact fast, convert to spec later, same hardened end state.
  5. Execute the outcome:
    • Drop — append one line to .engineer/discussions.log: <ISO-timestamp> | <slug> | dropped | <one-line why>. Draft the "why" from context; user confirms/edits.
    • Prototype — the idea is better built than specced: hand to the prototype skill (/engineer.prototype "<idea>") instead of feature-init. It iterates fast, then converts to spec (promote) into the pipeline later — the prototype-first entry (${CLAUDE_PLUGIN_ROOT}/references/two-paths.md). Do not create a feature here; prototype's promote does that on convergence.
    • Park — invoke feature-init with feature_intake { status: parked, autonomy_level: null, ... }.
    • Promote — first resolve autonomy_level (low/medium/high, charter caps surfaced); if the user can't decide, fall back to park. Then invoke feature-init with status: ready. If the idea came from a roadmap item, pass its roadmap_ref so feature-init back-links and marks it in-progress (see references/roadmap.md).
    • Keep the roadmap alive — when an idea is too big and decomposes into several future features, or you park something strategically worth tracking at the feature-list altitude, offer once to add it as a roadmap item (driver upsert, status: planned, a horizon) so the strategic layer stays current beyond onboard-time. The user's call — never auto-add. Skip silently if manifest.roadmap.type is none/unreachable.
  6. Handoff — for park/promote, write a <timestamp>-discuss.md handoff into the new feature folder. For drop, the log line is the record — no handoff.

Read the full file on GitHub · 43 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 43 lines · 54 tokens per session scan A 3ca0625c1d09

Subscribe to this mod's changes

discuss is a skill published in the GitHub repository swingerman/engineer (144 stars, last pushed 6d ago), licensed MIT. It adds 54 tokens to every session and 1,223 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

writing-tests

Write unit tests, component tests, and integration tests for AiderDesk using Vitest and React Testing Library. Use when creating new tests, adding test coverage, configuring mocks, setting up test files, or debugging failing tests.

hotovo/aider-desk · 48 tokens

release

Cut a sim-use release end-to-end. Use when the user runs /release or asks to "ship a release", "publish a version", "cut a release", or "release to homebrew". Drives scripts/local-release.sh; never reimplement its build/sign/tarball logic.

lycorp-jp/sim-use · 61 tokens

work-summary

Generates a project dashboard from MCP work items. Default is a lean, attention-first view: what's in flight, what's blocked, what to do next, what's queued. Use when the user says: project status, what's active, show me the dashboard, work summary, what should I work on, project health, what's blocked, where did I…

jpicklyk/task-orchestrator · 110 tokens

manage-schemas

Creates, views, edits, deletes, and validates note schemas for the MCP Task Orchestrator in .taskorchestrator/config.yaml — the templates that define which notes agents must fill at each workflow phase. Also recommends schema designs from a library of workflow patterns (autonomous coding loops, spec-driven teams…

jpicklyk/task-orchestrator · 212 tokens

bmad-dev-story

Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan".

LarsCowe/bmalph · 40 tokens

bmad-editorial-review-structure

Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure.

LarsCowe/bmalph · 35 tokens