# Personal Freedom Indicator Public Spec

## Purpose

Personal Freedom Indicator is a structural self-analysis instrument for estimating personal freedom under real-world constraints.

Important: this index does **not** measure happiness or life satisfaction.

## Canonical Data Source

For tooling and AI clients, use:

- `/about/` — static HTML (English body text; recommended for LLM fetch)
- `/spec/personal_freedom_index_spec.json` — application/json (schema v2)

This JSON includes:

- question bank (`ja` / `en` / `zh`; **en is authoritative for AI**)
- scoring formula and tier definitions
- `scoring.naApplicabilityPolicy`: **N/A is only for objective non-applicability**
- category metadata
- `anonymousProfile`: 10 anonymous fields (cohort gate + AI wizard requirements, enum labels)
- `appExperience`: UI locales, assessment flow, result screen layout, AI consultation wizard
- `assessmentFlowByLocale` and `notesForExternalUse`

## Live App (summary)

1. Intro → cohort gate (5 required profile fields) → 23 questions → optional subjective wellbeing (excluded from index) → results
2. Result screen: index, tier, category breakdown, self-analysis report
3. Primary action: 3-step AI consultation wizard (profile → task → preview/copy)
4. Generated AI prompts reference `/about/` for full question text and rules

## UI Languages

Ten fully localized UI and question banks: en, zh, hi, es, ar, pt, ru, fr, ja, ko.

## Human Specification

Project-level detailed Japanese spec:

- `docs/PersonalFreedomIndex_最新仕様書.md`

## Runtime Note

The main website is a Flutter/Dart SPA, so static HTML fetch of `/` may not contain rendered body text.
For reliable ingestion, fetch `/about/` and the JSON spec above.