Festina Overview

<branch condition="no active tasks">
  <action>Find highest priority task in planned, scoped, or backlog</action>
  <output>

Current Status

No tasks in progress.

Ready to start:

• {id}: {title} ({status})

Next: /festina-implement {id} </output> {{> skill-complete}} </branch>

<output>

Current Status

{For each active task, ordered by workflow stage:} {id}: {title}

• Status: {status}

• Progress: {completed}/{total} steps (if in-progress with plan)

• Next: {appropriate command for status}

  </output> <branch condition="projects were loaded (count > 0)"> <note>AC-F3: Show Projects section. Order: in-progress first, then open, then done.</note> <output>

Projects

{For each project, ordered: in-progress first, then open, then done (AC-F3):} {project-id}: {project-title} ({status})

• Progress: {done}/{total} tasks complete

• Tasks: {comma-separated child task IDs} </output> </branch>

  {{> skill-complete}} </step>

  <!-- ============================================ --> <!-- BOARD OVERVIEW --> <!-- ============================================ --> <step name="show_board_overview" when="view is 'board-overview'"> <action>Group tasks by status</action> <action>For in-progress tasks, read plan and count progress</action> <note>Order columns by workflow: in-progress, finalize, planned, scoped, backlog, done</note> <note>Only show columns that have tasks</note> <output>

Board Overview

In Progress ({count})

• {id}: {title} — {completed}/{total} steps

Check ({count})

• {id}: {title}

Update Docs ({count})

• {id}: {title}

PR ({count})

• {id}: {title}

Planned ({count})

• {id}: {title}

Scoped ({count})

• {id}: {title}

Backlog ({count})

• {id}: {title}

Done ({count})

• {id}: {title} </output>

  <branch condition="projects were loaded (count > 0)"> <note>AC-F3: Show Projects section. Order: in-progress first, then open, then done.</note> <output>

Projects

{For each project, ordered: in-progress first, then open, then done (AC-F3):} {project-id}: {project-title} ({status})

• Progress: {done}/{total} tasks complete

• Tasks: {comma-separated child task IDs} </output> </branch>

  {{> skill-complete}} </step>

  <!-- ============================================ --> <!-- VISUAL BOARD --> <!-- ============================================ --> <step name="show_visual_board" when="view is 'visual-board'"> <action>Group tasks by status</action>

  <note>Column order (workflow order):

1. backlog → "BACKLOG"

2. scoped → "SCOPED"

3. planned → "PLANNED"

4. in-progress → "IN PROGRESS"

5. check → "CHECK"

6. update-docs → "UPDATE DOCS"

7. pr → "PR"

8. done → "DONE"</note>

   <note>Box format:

┌─ {COLUMN NAME} ({count}) ─────────────┐
│ {id}: {title} [{label}]               │
└───────────────────────────────────────┘
```</note>

    <note>Rendering rules:
- Box width: 45 characters (adjust based on longest task line, min 40, max 60)
- Truncate titles with `...` if task line exceeds box width minus padding
- Show label only if task has one (first label if multiple)
- Skip columns with zero tasks
- For Done column: show `Done (N tasks)` without a box
- Use consistent box width for all columns</note>

    <output>
{Rendered visual board with ASCII boxes}

Done ({count} tasks)
    </output>

    <branch condition="projects were loaded (count > 0)">
      <note>AC-F3: Show Projects section below the board. Order: in-progress first, then open, then done.</note>
      <output>
## Projects

{For each project, ordered: in-progress first, then open, then done (AC-F3):}
**{project-id}: {project-title}** ({status}) — {done}/{total} tasks complete
  Tasks: {comma-separated child task IDs}
      </output>
    </branch>

    {{> skill-complete}}
  </step>

  <!-- ============================================ -->
  <!-- OTHER (free text input)                     -->
  <!-- ============================================ -->

  <step name="handle_other_input" when="view is 'other'">
    <action>Parse user input to determine intent</action>

    <branch condition="input looks like a task ID (e.g. '007', '12', 'task 5')">
      <action>Extract task ID and proceed to show_task_details</action>
    </branch>

    <branch condition="input mentions a label (e.g. 'show bugs', 'feature tasks')">
      <action>Filter tasks by that label</action>
      <output>
## Tasks labeled "{label}"

{For each matching task:}
- **{id}**: {title}
  - Status: {status}
  - Priority: {priority}

**Total:** {count} tasks
      </output>
      {{> skill-complete}}
    </branch>

    <branch condition="input mentions priority (e.g. 'high priority', 'urgent')">
      <action>Filter tasks by priority</action>
      <output>
## {priority} Priority Tasks

{For each matching task:}
- **{id}**: {title}
  - Status: {status}
  - Labels: {labels}

**Total:** {count} tasks
      </output>
      {{> skill-complete}}
    </branch>

    <branch condition="input asks about recent activity">
      <output>Recent activity is tracked in task files. Use `/festina-overview` with a task ID to see details.</output>
      {{> skill-complete}}
    </branch>

    <branch condition="cannot determine intent">
      <output>
I didn't understand "{input}". You can:
- Enter a task ID (e.g. "007")
- Ask about labels (e.g. "show bugs")
- Ask about priority (e.g. "high priority tasks")
      </output>
      {{> skill-complete}}
    </branch>
  </step>

  <!-- ============================================ -->
  <!-- TASK DETAILS                                -->
  <!-- ============================================ -->

  <step name="show_task_details" when="showing specific task" outputs="taskId">
    <command>node .festinalente/scripts/festinalente.cjs find-task {taskId}</command>
    <action>Read the file at the `path` from JSON output</action>

    <branch condition="task not found">
      <output>Task {taskId} not found.</output>
      {{> skill-complete}}
    </branch>

    <action>Extract title, status, labels, priority from task XML</action>
    <action>Read plan.xml if exists, count checkboxes</action>
    <action>Check for WIP Notes and Iterations sections</action>

    <output>
## Task {taskId}: {title}

**Status:** {status}
**Labels:** {labels}
**Priority:** {priority}

{If plan exists:}
**Progress:** {completed}/{total} steps complete

**Remaining steps:**
{List unchecked items}

{If WIP Notes exist:}
**WIP Notes:**
{notes}

{If Iterations exist:}
**Previous attempt failed:** {last failure summary}

    </output>

    <action>Suggest next command based on status:</action>
    <branch condition="status is backlog">
      <output>**Next:** `/festina-scope {taskId}`</output>
    </branch>
    <branch condition="status is scoped">
      <output>**Next:** `/festina-plan {taskId}`</output>
    </branch>
    <branch condition="status is planned">
      <output>**Next:** `/festina-implement {taskId}`</output>
    </branch>
    <branch condition="status is in-progress">
      <output>**Next:** `/festina-implement {taskId}` (resume)</output>
    </branch>
    <branch condition="status is finalize">
      <output>**Next:** `/festina-finalize {taskId}` or `/festina-rework {taskId}`</output>
    </branch>
    <branch condition="status is awaiting-completion">
      <output>**Next:** `/festina-complete {taskId}`</output>
    </branch>
    <branch condition="status is update-docs">
      <output>**Next:** `/festina-docs {taskId}`</output>
    </branch>
    <branch condition="status is pr">
      <output>**Next:** `/festina-merge {taskId}` or `/festina-rework {taskId}`</output>
    </branch>
    <branch condition="status is done">
      <output>Task complete.</output>
    </branch>

    {{> directive-compliance}}

    {{> skill-complete}}
  </step>
</process>

<success_criteria>
- Defaults to current status when no arguments provided
- Only the determined view is shown
- Task details include next command suggestion
- Free text input is handled flexibly
- Appropriate next commands suggested based on board state
</success_criteria>

<example label="Current Status (default)">
User: `/festina-overview`

Current Status

007: Add user authentication

• Status: in-progress
• Progress: 4/8 steps
• Next: /festina-implement 007

005: Fix login redirect

• Status: check
• Next: /festina-finalize 005 or /festina-rework 005

</example>

<example label="Board Overview">
User: `/festina-overview board`

Board Overview

In Progress (1)

• 007: Add user authentication — 4/8 steps

Check (1)

• 005: Fix login redirect

Planned (2)

• 008: Add password reset
• 009: Email notifications

Backlog (3)

• 010: Dark mode support
• 011: Performance improvements
• 012: Mobile responsive

Done (2)

• 001: Initial setup
• 002: Basic routing

</example>

<example label="Visual Board">
User: `/festina-overview visual`

┌─ IN PROGRESS (1) ─────────────────────┐ │ 007: Add user authentication [feature]│ └───────────────────────────────────────┘ ┌─ CHECK (1) ───────────────────────────┐ │ 005: Fix login redirect [bug] │ └───────────────────────────────────────┘ ┌─ PLANNED (2) ─────────────────────────┐ │ 008: Add password reset │ │ 009: Email notifications │ └───────────────────────────────────────┘ ┌─ BACKLOG (3) ─────────────────────────┐ │ 010: Dark mode support │ │ 011: Performance improvements │ │ 012: Mobile responsive │ └───────────────────────────────────────┘

Done (2 tasks)

</example>

<example label="Other - Task ID">
User: `/festina-overview 007`

Task 007: Add user authentication

Status: in-progress Labels: [feature] Priority: high

Progress: 4/8 steps complete

Remaining steps:

• Add session management
• Add logout endpoint
• Add password hashing
• Write tests

Next: /festina-implement 007 (resume)

</example>

<example label="Other - Label Query">
User: `/festina-overview show bugs`

Tasks labeled "bug"

• 005: Fix login redirect

  • Status: check
  • Priority: high

• 003: Memory leak in dashboard

  • Status: backlog
  • Priority: medium

Total: 2 tasks

</example>

<note>
**Box-Drawing Characters Reference:**

┌ ─ ┐ Top-left corner, horizontal, top-right corner │ │ Vertical sides └ ─ ┘ Bottom-left corner, horizontal, bottom-right corner

</note>

<next_steps>
Start a new task:

/festina-create

Work on a task (based on board state):

/festina-scope {id} /festina-plan {id} /festina-implement {id} /festina-finalize {id}

</next_steps>