# Fest Methodology

> Use when the user mentions festivals, the fest CLI, phases, sequences, or tasks, or when working inside a `festivals/` directory. Provides the core Festival methodology model so Claude understands the planning system.

- Skill: `obedience-corp/fest-methodology` (Agent Skill)
- Install (CLI): `npx skillmds@latest add obedience-corp/fest-methodology`
- Raw SKILL.md: https://api.skillmd.com/api/skills/obedience-corp/fest-methodology/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: Obedience-Corp (https://skillmd.com/u/obedience-corp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/obedience-corp/fest-methodology

---


# Festival Methodology

Festival Methodology is a goal-oriented project management system for human-AI development workflows. It replaces sprints, story points, and time estimates with **steps to goals**.

## Core Concepts

- **Festivals**: Top-level project containers with a specific goal
- **Phases**: Major stages (planning, implementation, review), prefixed `NNN_` (e.g., `001_PLAN/`)
- **Sequences**: Ordered groups of related tasks within a phase, prefixed `NN_` (e.g., `01_setup/`)
- **Tasks**: Atomic work units as markdown files, prefixed `NN_` (e.g., `01_create_schema.md`)

## Hierarchy

```
Festival
└── Phase       (NNN_UPPER_CASE/)
    └── Sequence    (NN_lower_snake_case/)
        └── Task        (NN_lower_snake_case.md)
```

## Lifecycle

```
planning/ → ready/ → active/ → dungeon/completed/
```

## Key CLI Commands

```bash
fest understand methodology    # Learn the methodology
fest create festival           # Create a new festival
fest next                      # Get next actionable task
fest task completed            # Mark task done
fest commit -m "msg"           # Commit with festival traceability
fest validate                  # Check structure
fest status                    # View progress
```

## When You Detect Festival Context

If you're working in a directory containing `festivals/`, or the user references festival methodology concepts, use `fest` commands rather than manual file manipulation. The CLI handles naming, validation, and traceability automatically.

Always run `fest next` to determine what to work on rather than manually picking tasks (it respects dependency order).