Decision Log

Decision Log is Q's singleton page for capturing durable project decisions in a format both humans and AI can reuse.

Use it when you want to answer questions like:

• Why did we choose this approach?
• Which technical or product calls are still active?
• What decisions should AI respect when drafting new work?

Core Concepts

Decisions

Each decision has:

• A title
• A durable one-liner
• An area (Product, Technical, GTM, Business, or custom)
• A status: Proposed, Active, or Superseded
• Optional decided by and decided at metadata
• An optional markdown body for deeper context

Areas

Areas let you group decisions into stable buckets. The defaults are:

• Product
• Technical
• GTM
• Business

You can add custom areas and reorder them from the Areas dialog in the toolbar.

Copy for AI

The Copy for AI button creates a markdown summary of all active decisions, grouped by area. This is useful when you want to paste the current decision set into another tool or conversation.

Adding and Editing

To add a decision:

1. Open the Decision Log page
2. Click Add Decision
3. Fill in the title, one-liner, area, status, and optional metadata
4. Save the entry
5. Use Edit Body from the 3-dot menu to write richer context and consequences

To update a decision:

Use the 3-dot menu on any card and choose Edit.

To supersede a decision:

Edit the entry and change the status to Superseded. Superseded entries remain in the log for historical context but are excluded from AI summaries.

AI Flow

Draft from toolbar

Click Draft with AI in the toolbar. A new sidebar chat opens with a pre-written prompt in the input box. Review the prompt, edit it if needed, and send it when you're ready. Q will then inspect the project context and create a structured decision entry using the Decision Log tools.

AI awareness

Sidebar AI, exports, and MCP project context can all read your Decision Log. Only active decisions are emphasized for AI summaries, so old or exploratory decisions do not dominate the context.