Documentation Index

Canonical source: docs/INDEX.md · Snapshot commit: 8739d34fda50

Life in Days — document index

Updated: 2026-08-14

This is the single navigation point for the Life in Days product, design, architecture, delivery, research, and governance documents.

Current status: The Phase 1 planning package and P0 execution-control package are published. Live issues and Project fields/views passed two zero-mismatch verifier snapshots; the generated Wiki was published separately and verified from a fresh clone. The directly activated Goal governs any later execution through a five-seat council and a per-task P0 Definition of Ready. The roadmap remains 58 work packages across P0 and R0–R10; all 58 six-artifact task dossiers are drafts and Incomplete/Hold, zero tasks are Ready, and zero have executionAllowed=true. No implementation release is Done. The R0 shared-host spike retains its historical In-progress roadmap status but is restricted to readiness/control documentation; no private-host probe is authorized. Deployment is Unknown — private read authority pending. Historical G0/G1 documents remain provenance. No implementation, credential collection, paid evaluation, provider configuration, infrastructure mutation, deployment, recovery exercise, or production verification is implied by the planning baseline, artifact generation, P0 publication, or Goal activation alone.

Phase 1 delivery baseline

Document	Purpose	Current role
AI Agent Operating Contract	Mandatory same-change workflow for keeping the manifest, GitHub issues, Project roadmap views, issue map, Markdown plan, Excel workbook, and running log synchronized.	Repository-wide instruction for every AI agent; evidence and authorization gates remain controlling.
AI Agent Resource Index — 2026-08-14 15:10:39 IST	Timestamped AI boot sequence, authority model, GitHub links, roadmap fields and views, milestone and 58-item task navigation, resource map, tooling, cautions, hashes, and complete tracked-file inventory.	Orientation snapshot only; current source documents and live GitHub evidence remain authoritative.
Codex Goal Prompt — P0 Requirements to Private Production	Copy-ready autonomous execution contract covering the 71 active P0 requirements, same-worktree continuity, five-role execution council, release loop, GitHub/Excel/Wiki synchronization, running-log cadence, production evidence, and non-delegable owner gates.	Directly activated on 2026-08-14; the current public-safe interpretation is the P0 execution authorization below. Activation is not implementation or deployment evidence.
P0 Execution Context Digest	Historical 2026-08-14 19:51 IST pre-publication repository, Git, GitHub/Project/Wiki, architecture, requirement/task, unknown, and next-work snapshot.	Provenance only; use the P0 control review and GitHub Project sync runbook for current publication/parity state.
P0 Execution Authorization	Reconciles the activated Goal with historical authority, routine R0–R8 delegation, private deployment authority, and human-only acts.	Current execution authority beneath direct owner decisions.
P0 Execution Council Charter	Five-seat membership, RACI, vetoes, release cadence, evidence, privacy, and naming controls.	Current execution governance.
P0 Execution Decisions	Dated decisions for authority, naming, R4, Health, prototype queue, containment, Wiki, and next work.	Append-only execution change control.
P0 Task Definition of Ready	Requires task-bound Product, Architecture, Design, QA, Delivery, and Council artifacts before substantive work.	Current start gate for all 58 canonical issues.
P0 Task Artifact Register	Machine-readable artifact paths, hashes, scenario IDs, owner actions, readiness, execution scope, and council disposition.	Canonical task-dossier readiness source; currently 58 Incomplete and zero execution-authorized.
P0 Task Readiness State	Editable task-level readiness/council overrides consumed by the dossier generator.	Change-controlled input; empty until an exact task passes specialist review.
P0 Task Work Items	Six P0-prefixed draft artifacts for each stable task ID.	Task-specific council inputs; generation is not approval.
P0 Owner Action Ledger	Public-safe inventory of all foreseeable non-delegable R0–R10 actions and opaque evidence references.	Current consolidated human-dependency source.
Product Council Decision Record	Reconciles Product, UX, Architecture, and Project decisions, including P0/R0–R10, evidence gates, and the shared-host baseline.	Current Phase 1 council authority beneath the global PRD and direct owner instructions.
Phase 1 Release Plan	Detailed 58-task schedule with milestones, dates, descriptions, requirements, task readiness, execution authorization, parent PRD/PID links, design inputs, ownership, and status rules.	Project Manager-owned delivery plan.
Phase 1 Roadmap Manifest	Machine-readable source for the Markdown plan, workbook, repository issues, and live GitHub Project, embedding every task dossier.	Canonical task/status/date/link/readiness projection.
GitHub Project Sync Runbook	Dry-run-first repository issue and Project V2 synchronization contract, schema, commands, recovery, and UI-only completion steps.	Operational publication guide; live verification is recorded separately from planning claims.
Phase 1 Excel Release Plan	Seven-sheet review workbook with summary charts, release plan, 58 tasks, weekly timeline, requirement map, and risks/gates.	Review artifact generated from the manifest.
Product Manager Review	Product framing, release decomposition, 78-requirement assignment, outcomes, risks, and task seed.	Specialist council recommendation reconciled by the decision record.
UX Design Review	v5 inspection, screenshots, design gaps, accessibility/privacy gates, and design traceability for all 58 tasks.	Specialist design evidence; prototype intent does not prove implementation.
Project Manager Review	Critical path, lane policy, Definition of Ready/Done, RAID, cadence, and GitHub operating model.	Delivery-control baseline.
Phase 1 Implementation Plan	Detailed architecture, domain, security, deployment, recovery, test, rollback, and work-package implementation guidance.	Technical planning authority; no deployed behavior implied.
Hetzner Shared-host Deployment Spike	First-party research, coexistence topology, SQLCipher/SQLite proof gates, PostgreSQL fallback, and live preflight plan.	Research/design complete; live capacity and coexistence proof remains outstanding.
Wayfinder Phase 1 Adoption Report	Deep assessment of the installed Wayfinder skill, Phase 1 fit, GitHub capabilities, source-of-truth boundaries, release-by-release use, risks, and a bounded R0 pilot.	Conditional recommendation only; no Wayfinder map, ticket, label, relationship, or Project change is authorized or implied.
GitHub Projects Roadmap Research	Deep current-capability research on Roadmap layouts, views, fields, automation, APIs, limits, and GitHub's public roadmap.	Historical research snapshot that informed the current Project model.
GitHub Roadmap Design Spike	Reversible eight-item pilot design, field taxonomy, view recipes, evidence policy, and operating rules.	Historical pilot design; the 58-task manifest now governs execution.
Shared-host Runbook	Sanitized commands, stop conditions, deployment, backup/restore, observation, and rollback sequence.	Execution guide; not evidence that commands have run.
Release PRDs and conditional PID	R0–R9 release-specific requirements plus date-free R10 transition definition.	Drafted planning artifacts; routine R0–R8 evidence gates are council-delegated, while named human acts remain separate gates.
Life Reflection GitHub Project	Status and date visualization of all manifest work packages.	Live control surface; documents and issue evidence remain authoritative.

Start here

Document	Purpose	Current role
Proposed Shared Understanding	Historical concise statement of the product promise, MVP boundary, capture model, AI/privacy rules, recovery direction, and deferrals.	Discovery provenance; the governing PRD and current Phase 1 decision record control the release plan.
Product Requirements Document	Complete product contract with 78 prioritized requirements, acceptance behavior, data handling, risks, and non-goals.	Council-approved G0 planning baseline.
UX Specification	Information architecture, screens, flows, states, content language, responsive behavior, accessibility, and validation plan.	Council-approved G0 planning baseline; no usability testing claimed.
Project Tracker	Historical G0–G9 gates, 12 milestones, 23 epics, 211 detailed tasks, dependencies, evidence, risks, decisions, and backlog.	Detailed historical task inventory; Phase 1 execution/status is governed by the 58-task manifest.
Implementation Plan	Earlier proposed architecture, domain model, integrations, jobs, security, storage, backup, testing, deployment, rollback, and technical gates.	Preserved planning baseline; the Phase 1 implementation plan is current for delivery.
Requirements Traceability	Maps each of the 78 PRD requirements to UX coverage, tracker tasks, architecture sections, and planned evidence.	Planning coverage is complete; code and executed evidence remain future work.
Product Council Review	Records specialist reviews, resolved findings, validation results, approvals, and G0 disposition.	Evidence that the integrated planning baseline passed council review.

Product governance and council

Document	What it contains
Product Council Charter	Council mandate, membership, source precedence, decision rights, review workflow, G0–G9 gates, RACI, and change control.
Council Review	Final G0 review record and the material contradictions resolved during reconciliation.
Phase 1 Product Council Charter	Current council membership, decision rights, evidence boundary, release gates, and four-lane roadmap contract.
Phase 1 Council Decision Record	Final reconciliation of the four specialist seats for P0 and R0–R10.
Product Manager Review	Product outcome, decomposition, requirement mapping, risks, and 58-task seed.
UX Design Review	v5 evidence, design gaps, screenshots, veto gates, and 58-task design traceability.
Project Manager Review	Critical path, status policy, readiness/completion rules, RAID, and GitHub operating model.
Senior Product Manager Charter	Product role mission, owned outputs, responsibilities, decision rights, review checklist, and guardrails.
UI/UX Design Lead Charter	Design role mission, owned outputs, responsibilities, decision rights, review checklist, and guardrails.
Project Manager Charter	Delivery-governance role mission, owned outputs, responsibilities, decision rights, review checklist, and guardrails.
Technical Architect Charter	Architecture role mission, owned outputs, responsibilities, decision rights, review checklist, and guardrails.
Independent QA Lead Charter	QA independence, evidence bundle, test matrices, severity, veto, AI-blind, and release-verdict contract.
P0 Execution-control Review	Five-seat readiness/acceptance findings, remediation checklist, publication evidence, package-level Published disposition, and the continuing per-task Hold boundary.

Product, experience, architecture, and delivery

Discipline	Primary document	Use it for
Product	Product Requirements Document	Product scope, user stories, exact behavior, acceptance criteria, priorities, non-goals, data handling, and risks.
Experience	UX Specification	Navigation, page anatomy, interaction rules, empty/error/conflict states, responsive design, accessibility, and content language.
Architecture	Phase 1 Implementation Plan	Current technical shape, persistence, integrations, security/privacy enforcement, AI orchestration, shared-host deployment, storage, operations, tests, and rollback.
Delivery	Phase 1 Release Plan	P0/R0–R10 milestones, 58 work packages, dates, owners, dependencies, statuses, evidence requirements, and GitHub contract.
Coverage	Requirements Traceability	Requirement-by-requirement navigation across Product, UX, Architecture, Delivery, and planned verification.

Active design exploration

Document	Purpose
Calendar UI prototype	Throwaway, simulated comparison of three calendar and Journal Day layout directions on prototype/calendar-ui-directions; no production behavior is implied.
Calendar UI prototype v2	Versioned Margin Companion revision of Archive Desk, Living Mosaic, and Monthly Almanac on prototype/calendar-ui-v2-margin-companion.
Calendar UI v2 design QA	Selected-reference comparison, captured v2 image set, interaction checks, responsive checks, and the bounded prototype QA result.
Unified Calendar and Almanac prototype v3	Selected single direction combining Living Mosaic as the default Calendar with a collapsible Monthly Almanac reading view on prototype/calendar-ui-v3-unified.
Calendar UI v3 prototype guide	Local run instructions, routes, screen inventory, responsive behavior, interactions, and prototype boundaries.
Calendar UI v3 design QA	Side-by-side design comparison, desktop/mobile interaction checks, accessibility review, fixes, and bounded QA result.
Museum Margin Calendar prototype v4	Approved revision with an image-only default Calendar and source provenance revealed in a selected-day right margin on prototype/calendar-ui-v4-museum-margin.
Calendar UI v4 prototype guide	Local run instructions, two-state URL model, image-only tile contract, responsive behavior, and prototype boundaries.
Calendar UI v4 design QA	Approved-reference comparisons, primary interaction checks, responsive sheet evidence, and bounded QA result.
Private Settings and compact privacy prototype v5	Source-grounded Settings suite and a subtle Journal Day privacy entry point on prototype/calendar-ui-v5-settings.
Calendar UI v5 prototype guide	Local routes, Settings screen inventory, responsive model, truthful simulated states, and prototype boundaries.
Calendar UI v5 design QA	Same-input privacy-density comparison, Settings screen review, interaction checks, responsive evidence, and bounded QA result.
Prototype v5 PRD feature audit	Product, design, and technical audit of all 78 PRD requirements, including missing/partial/placeholder coverage, current-run screenshots, and the recommended v6 completeness sequence.
Prototype completeness tracker	QA-gated v6–v35 remediation program mapping every prototype-representable v5 audit gap to one stable version while keeping backend proof outside prototype claims.
Private Search prototype v6	First remediation slice: page-memory-only Search terms, legacy q removal, and an honest no-suggestions initial state on prototype/calendar-ui-v6-private-search.
Calendar UI v6 prototype guide	Local run instructions, privacy behavior, deliberate Search limits, responsive intent, and evidence boundaries.
Calendar contract prototype v7	Second remediation slice: private-content-free month/year navigation, external Calendar state rings, progressive provenance, and cross-month keyboard behavior on prototype/calendar-ui-v7-calendar-contract.
Calendar UI v7 prototype guide	Local routes, Calendar/chooser interaction contract, frozen v6 Search regression, responsive behavior, and evidence boundaries.
Calendar UI v7 design QA	Independent chooser, Calendar-state, history/focus, responsive, motion, URL, console, and v6 Search-regression pass on the final v7 hashes.
Cross-month Almanac prototype v8	Third remediation slice: deterministic cross-month reading, one-month pagination, safe range state, Almanac index, jump, and canonical Journal Day return.
Calendar UI v8 prototype guide	Local routes, Cross-month Almanac interaction contract, inherited regressions, and prototype evidence boundaries.
Cross-month Almanac v8 council	Product, Design, and Project reconciliation for PVA-003.
Cross-month Almanac v8 independent QA	Exact artifact fingerprints, full interaction/responsive regression matrix, resolved findings, Pass verdict, and evidence boundary.
First-use Readiness prototype v9	Fourth remediation slice: empty Calendar plus independent VoiceNotes, Telegram, AI, Backup, and always-blocked Recovery Ceremony readiness.
Calendar UI v9 prototype guide	Local routes, truthful readiness fixtures, inherited regressions, and evidence boundaries.
First-use Readiness v9 council	Product, Design, and Project reconciliation for PVA-004.
First-use Readiness v9 independent QA	Exact artifact fingerprints, current-run interaction/responsive regression matrix, resolved findings, Pass verdict, and evidence boundary.
Resilient Application Shell prototype v10	Fifth remediation slice: coordinated loading, failure, interruption, unsaved-work, session, and guarded-retry states.
Calendar UI v10 prototype guide	Local run instructions, shell-state contract, deliberate limits, and review artifacts.
Resilient Application Shell v10 council	Approved Product, Design, and Project contract for PVA-005.
Resilient Application Shell v10 independent QA	Exact six-file fingerprint, current-run shell-state and regression matrix, Pass verdict, and evidence boundary.

Discovery and research record

These documents preserve how the current planning baseline was reached. Later confirmed decisions take precedence over earlier proposals.

Document	What it contains	Interpretation
Initial Brief	Original product request and inspiration links.	Historical input; later decisions supersede conflicts.
Detailed Discovery Requirements	The requirements interview record and decisions 1–65.	Canonical detailed discovery decisions beneath Arun's direct corrections.
Product and Integration Research	Research on inspiration products, VoiceNotes, Telegram, hosting, authentication, privacy, backup, and integrations.	Evidence base; distinguishes documented facts, observations, proposals, and unknowns.
Proposed Shared Understanding	Concise synthesis of the intended MVP.	Historical discovery artifact; not the current Phase 1 execution blocker.
AI Text Model Evaluation	Candidate comparison, privacy/cost analysis, synthetic test protocol, hard gates, and production contract for text AI.	Evaluation design only; no model is selected or qualified yet.
AI Artwork Model Evaluation	Candidate comparison, blind visual evaluation, privacy/cost controls, hard gates, and artwork configuration contract.	Evaluation design only; no model is selected or qualified yet.
Media Storage Evaluation	Cost, privacy, operational, backup, and migration comparison for local disk, R2, B2, and Hetzner alternatives.	Planning recommendation; provisioning and migration remain gated.
Worktree Provenance	Repository, branch, base, worktree, and isolation provenance for discovery work.	Historical Git provenance.

Domain language and repository entry points

Document	What it contains
AI Agent Operating Contract	Mandatory living-roadmap, GitHub synchronization, Excel regeneration, validation, safety, and handoff workflow for AI agents.
Domain Language	Canonical terms such as Journal Day, Journal Date, Source Item, Daily Photo, Original Timestamp, Correction, and Derived Artifact.
Repository README	Short project status, primary artifact links, and discovery entry points.
Publication Provenance	Scope of the clean public snapshot, intentional metadata exclusions, and the boundary between publication and product deployment.
Security and Privacy Reporting	Private vulnerability-reporting path and rules for sensitive content.
Contributing	Synthetic-data, status-language, documentation, and frozen-prototype contribution rules.

Recommended reading paths

To approve the product understanding

1. Proposed Shared Understanding
2. Detailed Discovery Requirements, when a statement needs its full decision history
3. Product Requirements Document, for the complete product contract

To design or review the experience

1. Product Requirements Document
2. Domain Language
3. UX Specification
4. Requirements Traceability

To prepare Phase 1 implementation after the named gates

1. Product Requirements Document
2. P0 Execution Authorization and Owner Action Ledger
3. Phase 1 Council Decision Record
4. The applicable release PRD/PID
5. UX Design Review and release-specific design evidence
6. Phase 1 Implementation Plan
7. Phase 1 Release Plan and Roadmap Manifest
8. Hetzner Shared-host Deployment Spike and Runbook for R0

To understand evidence and governance

1. Phase 1 Product Council Charter
2. P0 Execution Council Charter
3. P0 Execution Decisions
4. Phase 1 Council Decision Record
5. Project Manager Review
6. Phase 1 Release Plan
7. Requirements Traceability

Source precedence

When documents disagree, use this order:

1. Arun's direct decisions and corrections.
2. The Product Requirements Document for product behavior and stable requirement IDs.
3. The UX Specification for interaction behavior, subject to direct corrections and the PRD.
4. The Phase 1 Council Decision Record for release decomposition and planning decisions that do not alter the PRD.
5. The applicable release PRD/PID, Phase 1 Implementation Plan, and Phase 1 Roadmap Manifest within their disciplines.
6. The Detailed Discovery Requirements, Domain Language, discovery research, and historical G0/G1 council artifacts as provenance.

Do not silently resolve a remaining conflict by choosing the more convenient document. Record it through the Phase 1 Council Decision Record and affected manifest task.