# Harmonia

- [Product overview](https://docs.useharmonia.xyz/product/overview.md): Start here to understand Harmonia's purpose, production workflow, authority model, and operator experience.
- [Harmonia](https://docs.useharmonia.xyz/index.md): Autonomous social media content engine for startups — video in, verified posts out.
- [Architecture](https://docs.useharmonia.xyz/architecture.md): How Harmonia wires Gemini, ADK, Firestore, Pub/Sub, Cloud Run, and the web UI together.
- [Interactive architecture explorer](https://docs.useharmonia.xyz/architecture-explorer.md): Navigate Harmonia's agents, workflow, authority boundaries, state, APIs, effects, and verification progressively.
- [Evaluate Harmonia](https://docs.useharmonia.xyz/evaluation.md): A practical path for testing contracts, agent quality, authority boundaries, and end-to-end evidence.
- [The Pipeline](https://docs.useharmonia.xyz/pipeline.md): Stage by stage: ingest, transcribe, understand, strategize, approve strategy, plan, draft, approve effects, publish, verify, learn.
- [Generative A2UI console](https://docs.useharmonia.xyz/a2ui-console.md): Durable streamed chat runs, trusted presentation catalogs, hydration, uploads, and approval-safe operator UI.
- [Operator Interfaces](https://docs.useharmonia.xyz/interfaces.md): Dashboard, chat console, and Telegram — one pipeline behind every surface.
- [Proactive Agent](https://docs.useharmonia.xyz/proactive-agent.md): How Harmonia monitors trends, engagement, calendar health and failures on its own — and proposes next steps.
- [Production flow map](https://docs.useharmonia.xyz/diagrams/production-flow.md): Visual map from authorized source through strategy, production, approval, publishing, verification, and learning.
- [Authority boundaries map](https://docs.useharmonia.xyz/diagrams/authority-boundaries.md): Visual separation between agent reasoning, human decisions, deterministic control, and providers.
- [State ownership map](https://docs.useharmonia.xyz/diagrams/state-ownership.md): Visual guide to authoritative, transport, advisory, asset, and observability state.
- [Effect lifecycle map](https://docs.useharmonia.xyz/diagrams/effect-lifecycle.md): Visual map of proposal, digest-bound approval, command creation, claiming, execution, receipts, and verification.
- [Agent handoffs map](https://docs.useharmonia.xyz/diagrams/agent-handoffs.md): Typed payloads passed between Harmonia's bounded specialists.
- [Deployment topology map](https://docs.useharmonia.xyz/diagrams/deployment-topology.md): Visual topology for Harmonia's operator surfaces, Google Cloud runtime, data, models, and external APIs.
- [Guides overview](https://docs.useharmonia.xyz/guides/overview.md): Task-oriented paths for running, developing, integrating, and evaluating Harmonia.
- [Quickstart](https://docs.useharmonia.xyz/quickstart.md): Inspect Harmonia locally, then choose whether to configure authenticated Google execution.
- [Development](https://docs.useharmonia.xyz/development.md): Use explicit test fixtures, local emulators, and verification suites without confusing them with provider evidence.
- [How to sync content with Google Calendar](https://docs.useharmonia.xyz/google-calendar.md): Connect Google Calendar and explicitly add, update, or remove scheduled Harmonia content.
- [Agent team](https://docs.useharmonia.xyz/agents/overview.md): Reference for Harmonia's seven bounded Google ADK specialists.
- [ADK agent platform](https://docs.useharmonia.xyz/agent-platform.md): Coordinator, specialists, sequential drafting team, skills, managed sessions, and authority boundaries.
- [Nimi — evidence analyst](https://docs.useharmonia.xyz/agents/nimi.md): Nimi's source-analysis contract, evidence method, and authority boundary.
- [Ryan — content strategist](https://docs.useharmonia.xyz/agents/ryan.md): Ryan's strategy, content-brief, provenance, and approval-boundary reference.
- [Temi — editorial planner](https://docs.useharmonia.xyz/agents/temi.md): Temi's approved-strategy operationalization and production handoff reference.
- [Noni — copywriter](https://docs.useharmonia.xyz/agents/noni.md): Noni's selected-item writing, claim-grounding, and revision contract.
- [Dara — editor](https://docs.useharmonia.xyz/agents/dara.md): Dara's seven-dimension review and bounded revision contract.
- [Maya — A2UI presenter](https://docs.useharmonia.xyz/agents/maya.md): Maya's reference-only interface composition and hydration boundary.
- [Nova — read-only liaison](https://docs.useharmonia.xyz/agents/nova.md): Nova's skill-first read tools, evidence citations, and operator-answer contract.
- [Agent skills, tools, prompts, and traces](https://docs.useharmonia.xyz/reference/agent-runtime-inventory.md): Canonical runtime inventory for Harmonia's seven Google ADK specialists.
- [Sessions, history, and memory](https://docs.useharmonia.xyz/session-memory.md): How Harmonia separates invocation state, bounded conversation continuity, Firestore truth, and cross-session Memory Bank facts.
- [Models, cost, and evaluation](https://docs.useharmonia.xyz/models-cost-evaluation.md): Role-specific model policies, safety configuration, budget reservations, usage records, and evidence-gated promotion.
- [Agent tool contracts](https://docs.useharmonia.xyz/tool-contracts.md): The complete least-privilege contract for tools exposed to Harmonia's ADK liaison.
- [Platform and infrastructure](https://docs.useharmonia.xyz/platform/overview.md): Technology map for Harmonia's UI, agent runtime, durable state, integrations, media pipeline, and observability.
- [UI platform](https://docs.useharmonia.xyz/platform/ui/overview.md): How Harmonia presents deterministic workflow truth and bounded agent-generated surfaces.
- [Next.js](https://docs.useharmonia.xyz/platform/ui/nextjs.md): How Harmonia uses Next.js for its operator UI, authenticated API boundary, and deterministic workflow services.
- [Google A2UI](https://docs.useharmonia.xyz/platform/ui/a2ui.md): How Harmonia uses A2UI for bounded, server-hydrated generative operator surfaces.
- [Agents and AI platform](https://docs.useharmonia.xyz/platform/agents/overview.md): The Google agent and model services behind Harmonia's bounded specialist team.
- [Google ADK](https://docs.useharmonia.xyz/platform/agents/google-adk.md): How Harmonia uses Google ADK for typed specialist delegation, callbacks, skills, and managed state deltas.
- [Gemini](https://docs.useharmonia.xyz/platform/agents/gemini.md): How Harmonia allocates Gemini models across transcription and bounded specialist roles.
- [Noni writing runtime](https://docs.useharmonia.xyz/platform/agents/noni-runtime.md): How Harmonia runs skill-backed, provenance-bound copywriting.
- [Vertex AI Agent Engine](https://docs.useharmonia.xyz/platform/agents/agent-engine.md): How Harmonia uses Agent Engine as an ephemeral managed runtime for the ADK team.
- [Vertex AI Memory Bank](https://docs.useharmonia.xyz/platform/agents/memory-bank.md): How Harmonia uses scoped, evidence-linked memory as advisory cross-job context.
- [Security and identity platform](https://docs.useharmonia.xyz/platform/security/overview.md): Operator identity, workload identity, and secret boundaries in Harmonia.
- [Firebase Authentication](https://docs.useharmonia.xyz/platform/security/firebase-auth.md): How Google sign-in establishes Harmonia operator identity and tenant scope.
- [IAM and service accounts](https://docs.useharmonia.xyz/platform/security/iam-service-accounts.md): How Harmonia separates web, worker, Pub/Sub, and Scheduler identities with least privilege.
- [Secret Manager](https://docs.useharmonia.xyz/platform/security/secret-manager.md): How Harmonia supplies provider credentials to Cloud Run without placing secrets in code or client bundles.
- [Storage and messaging platform](https://docs.useharmonia.xyz/platform/data/overview.md): Durable state, asynchronous delivery, and binary asset storage in Harmonia.
- [Cloud Firestore](https://docs.useharmonia.xyz/platform/data/firestore.md): How Firestore owns Harmonia's durable workflow, authority, lineage, and audit records.
- [Cloud Pub/Sub](https://docs.useharmonia.xyz/platform/data/pubsub.md): How Harmonia uses Pub/Sub for recoverable asynchronous stage delivery.
- [Cloud Storage](https://docs.useharmonia.xyz/platform/data/cloud-storage.md): How Harmonia stores authorized uploads and generated binary artifacts outside Firestore.
- [Runtime and automation platform](https://docs.useharmonia.xyz/platform/runtime/overview.md): How Cloud Run and Cloud Scheduler host and wake Harmonia's durable workflow.
- [Cloud Run](https://docs.useharmonia.xyz/platform/runtime/cloud-run.md): How Harmonia deploys separate web and private worker services on Cloud Run.
- [Cloud Scheduler](https://docs.useharmonia.xyz/platform/runtime/cloud-scheduler.md): How authenticated scheduler ticks drive durable recovery and bounded resident checks.
- [Media platform](https://docs.useharmonia.xyz/platform/media/overview.md): Deterministic rendering and approval-gated generative media capabilities.
- [ffmpeg](https://docs.useharmonia.xyz/platform/media/ffmpeg.md): How Harmonia deterministically renders clips, reels, captions, and local media fixtures.
- [Vertex generative media](https://docs.useharmonia.xyz/platform/media/vertex-generative-media.md): How Harmonia gates image, Veo video, and Lyria audio generation behind typed proposals and budget controls.
- [Integration platform](https://docs.useharmonia.xyz/platform/integrations/overview.md): Official external APIs used for sources, operator access, calendars, signals, and publishing.
- [X API v2](https://docs.useharmonia.xyz/platform/integrations/x-api.md): How Harmonia publishes, verifies, and measures approved X posts through the official API.
- [Telegram Bot API](https://docs.useharmonia.xyz/platform/integrations/telegram.md): How Harmonia exposes tenant-scoped job, status, and approval interactions through Telegram.
- [Google Calendar API](https://docs.useharmonia.xyz/platform/integrations/google-calendar-api.md): How Harmonia explicitly synchronizes already scheduled content to an app-created calendar.
- [Hacker News Algolia API](https://docs.useharmonia.xyz/platform/integrations/hacker-news-algolia.md): How Nova and proactive checks obtain current public startup-technology signals.
- [YouTube source ingestion](https://docs.useharmonia.xyz/platform/integrations/youtube.md): How Harmonia resolves authorized YouTube videos for transcription and evidence-grounded analysis.
- [Logging and monitoring platform](https://docs.useharmonia.xyz/platform/observability/overview.md): Correlation, traces, structured logs, metrics, and usage budgets across Harmonia.
- [OpenTelemetry](https://docs.useharmonia.xyz/platform/observability/opentelemetry.md): How Harmonia propagates and records privacy-bounded execution traces.
- [Google Cloud Trace](https://docs.useharmonia.xyz/platform/observability/cloud-trace.md): How Cloud Trace is used as the target backend for correlated Harmonia execution traces.
- [Structured logging](https://docs.useharmonia.xyz/platform/observability/structured-logging.md): How Harmonia logs operational outcomes without leaking prompts, content, or credentials.
- [Monitoring and metrics](https://docs.useharmonia.xyz/platform/observability/monitoring-metrics.md): How Harmonia exposes job health, agent activity, failures, receipts, and model usage to operators.
- [Usage and budget accounting](https://docs.useharmonia.xyz/platform/observability/usage-budget.md): How Harmonia reserves model cost, records normalized usage, and fails closed on unknown pricing.
- [Operations overview](https://docs.useharmonia.xyz/operations/overview.md): Operate Harmonia through failure, recovery, approval, replay, observability, and deployment.
- [Bounded autonomy and operational KPIs](https://docs.useharmonia.xyz/operational-model.md): Where Harmonia reasons, where deterministic code controls execution, where humans retain authority, and how the demo is measured.
- [Failure and recovery reference](https://docs.useharmonia.xyz/failure-recovery.md): Typed failure categories, retry limits, escalation, replay, and fail-closed recovery behavior.
- [State ownership and retention](https://docs.useharmonia.xyz/state-ownership.md): The authoritative owner, scope, lifetime, writers, readers, and retention boundary for every Harmonia state store.
- [Authenticated record and replay](https://docs.useharmonia.xyz/record-replay.md): Capture, sanitize, review, and replay authenticated runs without fabricating evidence or mutating durable state.
- [Approvals & Audit](https://docs.useharmonia.xyz/approval-and-audit.md): The approval gate, idempotency receipts, and independent verification.
- [Governed resident autonomy](https://docs.useharmonia.xyz/resident-autonomy.md): Operate Heartbeat, Dream Cycle, Wakeup Call, experiments, and rollback without widening model authority.
- [Observability and trace lineage](https://docs.useharmonia.xyz/observability.md): W3C propagation, stage and agent spans, action lineage, privacy boundaries, and evidence correlation.
- [Deployment](https://docs.useharmonia.xyz/deployment.md): Target production topology on Google Cloud Run, Firestore, and Pub/Sub.
- [Context and memory continuity](https://docs.useharmonia.xyz/optimization/context-memory-continuity.md): The story of a Harmonia job that survives context trimming, stale memory, duplicate delivery, and a worker crash.
- [Reference overview](https://docs.useharmonia.xyz/reference/overview.md): Canonical contracts, routes, states, configuration, storage, authority, and evidence records.
- [Configuration](https://docs.useharmonia.xyz/configuration.md): Operator-facing runtime configuration, defaults, requirements, and source-of-truth boundaries.
- [Environment variable reference](https://docs.useharmonia.xyz/reference/environment.md): Index of Harmonia configuration domains and the source files that validate them.
- [Google Calendar sync reference](https://docs.useharmonia.xyz/google-calendar-reference.md): OAuth scope, API routes, event projection, persisted states, idempotency, errors, and verification behavior.
- [API routes reference](https://docs.useharmonia.xyz/reference/api-routes.md): The public operator, integration, and internal worker route families exposed by Harmonia.
- [Media upload reference](https://docs.useharmonia.xyz/reference/upload-media.md): Tenant-scoped upload sessions, source-rights declarations, completion, and ingestion handoff.
- [Job state machine reference](https://docs.useharmonia.xyz/reference/job-state-machine.md): Canonical Harmonia stages, gates, terminal states, and transition ownership.
- [Agent contracts reference](https://docs.useharmonia.xyz/reference/agent-contracts.md): Strict inputs, outputs, evidence requirements, and authority limits for every Harmonia specialist.
- [Effect contracts reference](https://docs.useharmonia.xyz/reference/effect-contracts.md): Commands, authorization, claims, idempotency, and terminal effect outcomes.
- [Error taxonomy reference](https://docs.useharmonia.xyz/reference/error-taxonomy.md): Normalized failure categories, retry rules, and safe public reporting.
- [Firestore data reference](https://docs.useharmonia.xyz/reference/firestore-data.md): Tenant hierarchy and durable record families used as Harmonia's workflow truth.
- [Authority matrix reference](https://docs.useharmonia.xyz/reference/authority-matrix.md): Who may reason, decide, persist, schedule, execute, and verify in Harmonia.
- [Pricing and budget reference](https://docs.useharmonia.xyz/reference/pricing-budget.md): Versioned model pricing, reservations, observed usage, and paid-operation policy.
- [Receipts and verification reference](https://docs.useharmonia.xyz/reference/receipts-verification.md): Immutable execution evidence, independent read-back, and replay lineage.
- [How to capture Google Cloud deployment evidence](https://docs.useharmonia.xyz/cloud-proof.md): Capture judge-visible proof of Agent Engine, Memory Bank, Cloud Run, Firestore, Pub/Sub, and correlated execution.
- [Authenticated vertical-slice evidence](https://docs.useharmonia.xyz/evidence-runbook.md): Fail-closed protocol for proving one real Harmonia run without exposing private content.
- [Glossary](https://docs.useharmonia.xyz/glossary.md): Shared vocabulary for Harmonia's agents, workflow, authority, evidence, and operations.