qualia-discuss

Capture decisions and constraints into .planning/phase-{N}-context.md before planning.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-discuss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qualia-discuss
Source: https://github.com/Qualiasolutions/qualia-framework/tree/main/skills/qualia-discuss
Command: npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-discuss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture decisions, trade-offs, and constraints before planning to ensure the planner uses locked inputs.

Core Features & Use Cases

  • Generates a locked phase context file at .planning/phase-{N}-context.md to lock decisions for the upcoming plan.
  • Records discrete decisions, rationale, sources, and any discretionary items or open questions to guide the planner.
  • Ideal for regulated domains or architectural forks where early input must be preserved during planning.

Quick Start

Invoke qualia-discuss to capture phase decisions and write .planning/phase-{N}-context.md.

Frequently Asked Questions about qualia-discuss

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

FAQPage Schema
How do I lock planning decisions before creating a project plan?

Locking phase decisions before planning involves capturing discrete decisions, trade-offs, and constraints into a phase-context file. This guarantees the planner uses locked inputs, which is critical in regulated domains or architectural forks.

What is phase context metadata and when do I need it for planning?

Phase context metadata records decisions, rationale, and open questions to guide the planner. You need it for complex phases in regulated or architectural contexts where early input must be preserved and locked before planning begins.

How do I capture decisions and constraints for regulated project planning?

Capture decisions for regulated project planning by recording discrete choices, trade-offs, sources, and open questions. This locks the input constraints and writes them to a phase-context file, ensuring compliance and preserving early architectural input.

Can I record discretionary items and open questions before locking a plan?

Yes, you can record discretionary items and open questions alongside discrete decisions and rationale. Capturing these before planning ensures the planner receives a complete locked input view of both constraints and unresolved architectural items.

What is the best way to preserve architectural decisions during project phases?

The best way to preserve architectural decisions is to capture them in a locked phase context file before planning. This records discrete decisions, rationale, and trade-offs, ensuring early input is preserved and applied during complex architectural forks.

Does capturing phase decisions work without external dependencies?

Yes, capturing phase decisions works without external dependencies. The process independently writes phase-context metadata to a markdown file, ensuring locked input for the planner without requiring additional tools or frameworks.