3. Update Challenge Voice

Purpose: Modify voice constitution, style rules, difficulty levels, or other rules that govern how challenge content is generated.

Prerequisites:

  • Bun installed with bun install completed
  • Familiarity with the challenge content generation system

Cost / Duration: $0 | 15-30 minutes

Prompt

Update challenge voice and content rules for the Eko system.

I need to change: [describe what you want to update, e.g.,
"adjust the voice constitution tone",
"update difficulty scaling for level 3",
"refine style rules for conciseness"]

Step 1 — Edit the relevant TypeScript config files:

Depending on what you are changing, edit one or more of:

- `packages/ai/src/config/challenge-style-rules.ts`
  Style enforcement rules.

- `packages/ai/src/config/challenge-style-voices.ts`
  Style-specific voice instructions.

- `packages/ai/src/config/challenge-difficulty.ts`
  Difficulty tier definitions.

- `packages/ai/src/config/challenge-banned-patterns.ts`
  Regex patterns for CQ violations.

- `packages/ai/src/config/challenge-voice.ts`
  Contains `CHALLENGE_VOICE_CONSTITUTION` (master voice
  constitution) and `SUPER_FACT_RULES` (super-fact
  generation rules). Edit these exported constants directly.

Each file exports typed constants -- follow the existing
shapes when adding or modifying entries.

Step 2 — Verify TypeScript compiles:

```bash
bun run typecheck
```

Step 3 — Run drift tests:

```bash
bunx vitest run packages/ai/src/drift/__tests__/
```

This validates that the updated rules pass semantic drift
checks and do not conflict with existing voice invariants.

Key references:
- Voice constitution: `packages/ai/src/config/challenge-voice.ts`
- Challenge content generation: `packages/ai/src/challenge-content.ts`
- Challenge content rules: `packages/ai/src/challenge-content-rules.ts`

Verification

  • Config file(s) updated with new entries or modified values
  • bun run typecheck passes
  • Drift tests pass with no regressions
  • If voice constitution changed, review output tone in a test generation run
  • Rule priority and ordering reviewed (rules are applied in array order)

Back to index