no-vibe-challenge

no-vibe-challenge

Generate a hands-on coding challenge. The user writes everything.

Inputs

Treat text after $no-vibe-challenge as an optional focus area.

Examples:

• $no-vibe-challenge
• $no-vibe-challenge error handling
• $no-vibe-challenge recursion

Workflow

1. Activate no-vibe mode

Run:

mkdir -p .no-vibe/notes .no-vibe/refs .no-vibe/data/sessions && touch .no-vibe/active

Verify:

test -f .no-vibe/active

If verified, state: no-vibe is active (.no-vibe/active exists).

2. Determine challenge context

Check for in-progress sessions:

grep -rl '"status": "in_progress"' .no-vibe/data/sessions/ 2>/dev/null

• If an active session exists: read session JSON and generate a challenge that reinforces what the user just learned.
• If no active session exists: inspect the project to infer stack/domain and generate a relevant challenge.
• If a focus area was provided: narrow challenge scope to that area while keeping project/session relevance.

3. Read learner data

If present, read:

• ~/.no-vibe/profile.md — global learner meta-model (cross-project skill levels, recurring teaching gaps, preferences). See skills/no-vibe/DATA-SCHEMA.md for the contract; ~/.no-vibe/.synth-state.json is bookkeeping only and must NOT be loaded.
• .no-vibe/data/mistakes.json — project-local teaching gaps

Calibrate challenge difficulty:

• struggling or new: smaller scope, tighter acceptance criteria
• comfortable or strong: broader scope, less hand-holding
• recurring mistakes: challenge should exercise that category

4. Present the challenge

Use this structure:

Challenge: {title}

{1-3 sentence description}

Acceptance criteria:

• {specific, testable criterion}
• {specific, testable criterion}

Run command: {exact command to test}

Ready? Start coding. Ask for hints anytime, or say "review" when done.

Rules:

• No code output for the user to copy.
• Acceptance criteria must be observable/testable.
• Scope should fit 5-20 minutes.

5. Guide and review

After presenting:

• Provide hints, not full solutions.
• When user says "review", read their code and provide feedback.
• On completion, log a challenge session to .no-vibe/data/sessions/challenge-<slug>.json with mode "skill".

6. Deactivate (one-shot)

When challenge flow is finished:

rm -f .no-vibe/active

Verify:

test ! -f .no-vibe/active

If verified, state: no-vibe is off (.no-vibe/active removed).

Hard rules

• Never write code to project files.
• Challenge must stay in 5-20 minute scope.
• Always calibrate difficulty using learner data when available.
• In active mode, .no-vibe/** is the only write-allowed area.