# Goals

Arete supports five goal frameworks side by side. Pick the one that matches the
kind of outcome you're after — they're not mutually exclusive, and most users
mix.

## Choosing a framework

| Framework        | Best for                                            |
| ---------------- | --------------------------------------------------- |
| **SMART**        | Concrete deliverables ("Run a 10K by June 30")      |
| **OKR**          | Ambitious objectives where the path isn't clear yet |
| **WOOP**         | Habit-shaped goals with predictable obstacles       |
| **12-Week Year** | Quarter-length pushes with weekly accountability    |
| **Free-form**    | Goals you don't want to formalize yet               |

## SMART

Specific, Measurable, Achievable, Relevant, Time-bound.

Arete validates each criterion as you type:

- **Specific** — checks for clear definition (action verb + concrete object).
- **Measurable** — checks for a quantifier (number, date, %).
- **Achievable** — prompts you to estimate confidence 1–10. Below 4 the app
  flags the goal as wishful.
- **Relevant** — links to a Role and a Value from your Vision setup.
- **Time-bound** — requires a deadline.

The SMART score (out of 100) updates live as you fill in fields. SMARTER extends
the framework with **Evaluated** (review cadence) and **Reviewed**
(post-completion reflection).

## OKR

OKRs pair a qualitative **Objective** with 3–5 quantitative **Key Results**.
Each KR is one of:

- **Committed** — you're confident you can hit it.
- **Aspirational** — moonshot. Hitting 70% is a success.

Score each KR 0.0–1.0. The Objective's score is the average of its KRs. Arete
flags an OKR as healthy when the average lands between 0.6 and 0.8 — too high
means you didn't aim ambitious enough; too low means you over-committed.

Quarterly cycles run check-ins every 1–2 weeks. The Coach suggests adjustments
based on your confidence level.

## WOOP

Mental contrasting: pair the **Wish** + **Outcome** (what success looks like)
with the **Obstacle** (what historically derails you) + **Plan** (if-then
statement to defeat the obstacle).

Implementation intentions stored as `if [trigger] then [action]` are
research-backed for closing the intention-behavior gap.

## 12-Week Year

A 12-week sprint with weekly scoring. Each week you score yourself out of 100%
on lead and lag indicators:

- **Lead indicators** — actions you control (e.g. "5 study sessions").
- **Lag indicators** — outcomes (e.g. "TypeScript chapter complete").

Friday Weekly Accountability Meeting (WAM) prompt walks you through score,
blockers, and next-week commitments. Arete builds your 12 Week Year score over
the cycle and surfaces it in the Goals → Analytics tab.

The 13th week is a review buffer.

## Goal hierarchy

Open any goal → **Hierarchy** to see parents and children. Arete encourages a
cascade:

- Life vision → 10-year → 5-year → annual → quarterly → monthly → weekly →
  daily.

The Goals tree visualizer shows orphan goals (no parent) so you can either link
them up or delete them.

## Tracking progress

Each goal has a `progress` percentage 0–100. You can:

- **Manually update** via the +/- buttons on the goal card.
- **Auto-derive** from linked habits (the Coach can suggest this).
- **Update via the API** — `POST /v1/goals/:id/progress`.

Completion (progress = 100) triggers a celebration animation, awards points, and
unlocks any milestone badges.

## Abandoning a goal

Sometimes the goal stops mattering. Mark it abandoned via Goal detail → **More**
→ **Abandon goal** and Arete prompts a short reflection: what did you learn?
Reflections appear in your Journal as a special "abandoned-goal" entry tag.

## Analytics

Goals → Analytics shows:

- **Goals by status** — not_started / in_progress / completed / abandoned /
  paused.
- **Goals by type** — pie chart of SMART / OKR / WOOP / 12-Week / free.
- **6-month completion series** — bar chart per month.
- **Average progress** — across all in-progress goals.
- **Success rate** — completed / total.

## Common pitfalls

- **Setting too many goals** — research shows >5 in-progress goals splits
  attention. Arete warns when you cross that line.
- **No review cadence** — without a weekly check-in, goals drift. Add the WAM to
  your calendar.
- **Not linking to identity** — a goal with no link to a value or role feels
  arbitrary. Use the Vision setup to ground your goals.
