REGISTER - Create New Brief

Register a new brief for tracking bugs, features, migrations, or technical debt.

Usage

/register bug "Title of the bug"
/register feature "Title of the feature"
/register migration "Title of migration"
/register debt "Title of technical debt"

Or without type (will prompt):

/register "Brief title"

Arguments

$ARGUMENTS format: [type] "title" or just "title"

Types and their prefixes:

• bug or feature → BR-XXX
• migration → MG-XXX
• debt → TD-XXX
• testing → TS-XXX
• process → PI-XXX
• request → FR-XXX
• dependency → DU-XXX
• performance → PF-XXX
• architecture → AC-XXX

Execution

0. Track Invocation

Silently emit a skill invocation event (never blocks execution):

bash
1bash "$CLAUDE_PROJECT_DIR/scripts/emit_skill_event.sh" "register" 2>/dev/null || true

1. Parse Arguments

Extract type and title from $ARGUMENTS. If type not specified, ask user which type.

2. Determine Prefix

Map type to brief prefix:

3. Find Next Available Number

Scan ai/briefs/ for existing briefs with this prefix. Find highest number, add 1. Example: If BR-007 exists, next is BR-008.

4. Read Template

Read template from ai/briefs/{PREFIX}-TEMPLATE.md. Fallback to ai/briefs/BR-TEMPLATE.md if specific template not found.

5. Create Brief File

Create ai/briefs/{PREFIX}-{XXX}-{slug}.md:

• Fill in title from arguments
• Set Status: Ready (or Draft if info incomplete)
• Set Priority: P2 (default, can be changed)
• Set Created date: today
• Leave other fields for user to complete

6. Handle P0/P1 Priority

If user specifies P0 or P1 priority, also add entry to ai/session/BLOCKERS.md.

7. Sync Brief to Brain

If the igris-brain MCP server is available, call igris_brief_sync with:

• project: current project slug (derive from directory name or brain registry)
• brief_id: the new brief ID (e.g., "FR-031")
• brief_type: type from the brief (feature, bug, tech_debt, migration, testing, process, dependency, performance, architecture)
• title: the brief title
• status: "Ready" (or "Draft" if incomplete)
• priority: the assigned priority (e.g., "P2")
• effort: the assigned effort (e.g., "S", "M", "L", "XL") if known
• phase: "INIT"

If brain MCP is not available, skip silently. No errors.

8. Confirm Registration

Display:

Brief registered: {PREFIX}-{XXX}

File: ai/briefs/{PREFIX}-{XXX}-{slug}.md
Type: [Bug Fix | Feature | Migration | etc.]
Priority: P2 (default)
Status: Ready

To implement: /hunt {PREFIX}-{XXX}
To change priority: "change {PREFIX}-{XXX} priority to P0"

Important

• DO NOT load context files
• DO NOT start implementation
• DO NOT create tasks
• ONLY create the brief file and sync to brain