/add-idea Command
<!-- Template Version: 2 | ContextKit: 0.2.0 | Updated: 2025-10-02 -->
Capture New Ideas with Quick Dump
<!-- Template Version: 2 | ContextKit: 0.2.0 | Updated: 2025-10-02 -->[!WARNING] š©āš» FOR DEVELOPERS: Do not edit the content above the developer customization section - changes will be overwritten during ContextKit updates.
For project-specific customizations, use the designated section at the bottom of this file.
Found a bug or improvement for everyone? Please report it: https://github.com/FlineDev/ContextKit/issues
Description
Quick idea capture with minimal overhead. Takes description as parameter and dumps to inbox immediately with source extraction if mentioned.
Parameters
description(required): The idea description (e.g., "Add dark mode support" or "Jack suggested export to CSV feature")
Execution Flow (main)
Phase 0: Check Customization
- Read the "š©āš» DEVELOPER CUSTOMIZATIONS" section
- Use
Greptool to find the start of the section - Read everything below that line contained in this document til the end of the file
- Make sure to consider what was said there with high priority
- If anything conflicts with the rest of the workflow, prioritize the "developer customizations"
- Use
Phase 1: Setup Validation
- Check Ideas Infrastructure
- Use
Globtool to verify:Glob Context/Backlog Ideas-Inbox.md - If Ideas-Inbox.md missing:
ā END (exit with error)ā Ideas infrastructure not found! Run /ctxk:proj:init to setup ContextKit backlog system.
- Use
Phase 2: Quick Processing
-
Parse Description and Extract Source
- Take description from command parameter
- If no description provided: ERROR "Description required: /ctxk:bckl:add-idea 'Your idea here'"
- Extract source if mentioned: Look for patterns like:
- "Jack said...", "Customer suggested...", "Sarah mentioned..."
- "User reported...", "Support ticket mentioned..."
- If found: Extract as source, clean description
- If not found: Source = "Me"
-
Generate ID and Create Entry
- Use
Readtool to read Ideas-Inbox.md:Read Context/Backlog/Ideas-Inbox.md - Generate next sequential ID: IDEA-001, IDEA-002, etc.
- Create title from description (fix obvious typos, keep intent)
- Generate current date
- Use
-
Add to Ideas Inbox
- Use
Edittool to add entry at top of "Ideas Awaiting Evaluation" section:## [IDEA-###] [Title from description] **Added**: YYYY-MM-DD **Source**: [Extracted source or "Me"] **Context**: [Full description if longer than title]
- Use
-
Show Success Message
š” Idea captured: [IDEA-###] [Title] š Added to Context/Backlog/Ideas-Inbox.md š Run /ctxk:bckl:prioritize-ideas to evaluate and prioritize
Error Conditions
- "No description provided" ā Show usage:
/ctxk:bckl:add-idea "Your idea description" - "Ideas-Inbox.md missing" ā Run
/ctxk:proj:initto setup infrastructure - "File write failed" ā Check permissions and disk space
Source Extraction Patterns
Look for these patterns in description and extract as source:
- "Jack said we need dark mode" ā Source: "Jack", Description: "Dark mode support"
- "Customer reported wanting CSV export" ā Source: "Customer", Description: "CSV export functionality"
- "Support ticket mentioned offline mode" ā Source: "Support ticket", Description: "Offline mode"
- "Add dark mode" ā Source: "Me", Description: "Dark mode support"
Integration Points
- Quick capture: Minimal questions, fast entry
- Evaluation later:
/ctxk:bckl:prioritize-ideashandles all assessment - Source tracking: Basic attribution for follow-up
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā š©āš» DEVELOPER CUSTOMIZATIONS - EDITABLE SECTION āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
This section is preserved during ContextKit migrations and updates. Add project-specific instructions, examples, and overrides below.