concept:blackbox

/concept:blackbox

Phase 3 of concept development: black-box architecture.

Prerequisites

Run the prerequisite gate check:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/update_state.py --state .concept-dev/state.json check-gate blackbox

If this exits non-zero, stop and tell the user to complete the previous phase first.

Then load context:

• python3 ${CLAUDE_PLUGIN_ROOT}/scripts/update_state.py --state .concept-dev/state.json show
• Read: .concept-dev/PROBLEM-STATEMENT.md

Procedure

Step 1: Set Phase

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/update_state.py --state .concept-dev/state.json set-phase blackbox

Step 2: Context Loading

Read .concept-dev/PROBLEM-STATEMENT.md and present:

===================================================================
BLACK-BOX ARCHITECTURE
===================================================================

Problem: [1-2 sentence summary]
Scope: [IN scope summary]
Key Constraints: [List]

I'll propose 2-3 high-level approaches to solving this problem.
Each approach describes WHAT the concept does at a functional level
— not HOW it's implemented.

For each approach, I'll describe:
  - Functional blocks and their responsibilities
  - Relationships between blocks
  - Guiding principles
  - Capabilities this architecture enables
  - Trade-offs

===================================================================

Step 3: Propose Approaches

Use the concept-architect agent. Present 2-3 distinct architectural approaches:

===================================================================
APPROACH 1: [Name]
===================================================================

CONCEPT: [2-3 sentence description]

FUNCTIONAL BLOCKS:
  [Block A] — [What it does, not how]
  [Block B] — [What it does, not how]
  [Block C] — [What it does, not how]

RELATIONSHIPS:
  [Block A] → [Block B]: [What flows between them]
  [Block B] ↔ [Block C]: [Bidirectional relationship]

PRINCIPLES:
  1. [Guiding principle]
  2. [Guiding principle]

ENABLES:
  - [Capability this approach uniquely enables]
  - [Capability]

TRADE-OFFS:
  + [Advantage]
  + [Advantage]
  - [Disadvantage]
  - [Disadvantage]

===================================================================
APPROACH 2: [Name]
===================================================================
[Same structure]

===================================================================
APPROACH 3: [Name]
===================================================================
[Same structure]