# Harmonia — Agents for Humans

> Product, operator, and engineering documentation for Harmonia's Strands Agents SDK and AWS edition.

- [Product overview](https://docs.app.useharmonia.xyz/product/overview.md): Start here to understand Harmonia's purpose, production workflow, authority model, and operator experience.
- [Harmonia — Agents for Humans](https://docs.app.useharmonia.xyz/index.md): Build and operate Harmonia's governed Strands Agents SDK and AWS content system.
- [Agents for Humans edition](https://docs.app.useharmonia.xyz/agents-for-humans.md): The repository, domain, architecture, and evidence boundary for Harmonia's Strands Agents SDK and AWS implementation.
- [Content strategy is rarely the bottleneck. Execution is.](https://docs.app.useharmonia.xyz/content-execution.md): How Harmonia turns authorized startup sources into a governed content workflow, and what remains unverified.
- [Interactive architecture](https://docs.app.useharmonia.xyz/architecture.md): Trace Harmonia's information, state, authority, effects, recovery, and telemetry flows.
- [System architecture](https://docs.app.useharmonia.xyz/architecture/overview.md): AWS control plane, Strands cognition, native media, durable authority and independent verification.
- [Interactive architecture explorer](https://docs.app.useharmonia.xyz/architecture-explorer.md): Navigate Harmonia's agents, workflow, authority boundaries, state, APIs, effects, and verification progressively.
- [Evaluate Harmonia](https://docs.app.useharmonia.xyz/evaluation.md): A practical path for testing contracts, agent quality, authority boundaries, and end-to-end evidence.
- [The Pipeline](https://docs.app.useharmonia.xyz/pipeline.md): Stage by stage: collect sources, extract sources, understand, strategize, approve strategy, plan, draft, approve effects, publish, verify, learn.
- [Generative AI SDK console](https://docs.app.useharmonia.xyz/ai-sdk-console.md): Durable streamed chat runs, trusted presentation catalogs, hydration, uploads, and approval-safe operator UI.
- [Operator Interfaces](https://docs.app.useharmonia.xyz/interfaces.md): Dashboard, chat console, and Telegram — one pipeline behind every surface.
- [Proactive Agent](https://docs.app.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.app.useharmonia.xyz/diagrams/production-flow.md): Visual map from authorized source through strategy, production, approval, publishing, verification, and learning.
- [Authority boundaries map](https://docs.app.useharmonia.xyz/diagrams/authority-boundaries.md): Visual separation between agent reasoning, human decisions, deterministic control, and providers.
- [State ownership map](https://docs.app.useharmonia.xyz/diagrams/state-ownership.md): Visual guide to authoritative, transport, advisory, asset, and observability state.
- [Effect lifecycle map](https://docs.app.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.app.useharmonia.xyz/diagrams/agent-handoffs.md): Typed payloads passed between Harmonia's bounded specialists.
- [Deployment topology map](https://docs.app.useharmonia.xyz/diagrams/deployment-topology.md): Visual topology for Harmonia's operator surfaces, AWS runtime, data, models, and external APIs.
- [Guides overview](https://docs.app.useharmonia.xyz/guides/overview.md): Task-oriented paths for running, developing, integrating, and evaluating Harmonia.
- [Quickstart](https://docs.app.useharmonia.xyz/quickstart.md): Verify the AWS edition locally before separately authorized cloud execution.
- [Development](https://docs.app.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.app.useharmonia.xyz/google-calendar.md): Connect Google Calendar and explicitly add, update, or remove scheduled Harmonia content.
- [Agent team](https://docs.app.useharmonia.xyz/agents/overview.md): Seven operational specialists under Harmonia's deterministic coordinator.
- [Strands agent platform](https://docs.app.useharmonia.xyz/agent-platform.md): Native Strands task registrations, host-preloaded skills, request hooks, and AgentCore execution.
- [Nimi — evidence analyst](https://docs.app.useharmonia.xyz/agents/nimi.md): Current Strands registration, model, inputs, tools and authority.
- [Ryan — content strategist](https://docs.app.useharmonia.xyz/agents/ryan.md): Current Strands registration, model, inputs, tools and authority.
- [Temi — editorial planner](https://docs.app.useharmonia.xyz/agents/temi.md): Current Strands registration, model, inputs, tools and authority.
- [Noni — content producer](https://docs.app.useharmonia.xyz/agents/noni.md): Current Strands registration, model, inputs, tools and authority.
- [Dara — editorial reviewer](https://docs.app.useharmonia.xyz/agents/dara.md): Current Strands registration, model, inputs, tools and authority.
- [Maya — AI SDK presenter](https://docs.app.useharmonia.xyz/agents/maya.md): Current Strands registration, model, inputs, tools and authority.
- [Nova — read-only liaison](https://docs.app.useharmonia.xyz/agents/nova.md): Current Strands registration, model, inputs, tools and authority.
- [Agent skills, tools, prompts, and traces](https://docs.app.useharmonia.xyz/reference/agent-runtime-inventory.md): Actual Strands registrations and host-selected capability boundaries.
- [Sessions, history, and memory](https://docs.app.useharmonia.xyz/session-memory.md): How Harmonia separates invocation state, bounded conversation continuity, DynamoDB truth, and cross-session AgentCore Memory facts.
- [Models, cost, and evaluation](https://docs.app.useharmonia.xyz/models-cost-evaluation.md): Native Bedrock role policies, explicit deployment pricing, reservations, and evidence requirements.
- [Agent tool contracts](https://docs.app.useharmonia.xyz/tool-contracts.md): The complete least-privilege contract for tools exposed to Harmonia's Strands liaison.
- [Platform and infrastructure](https://docs.app.useharmonia.xyz/platform/overview.md): Technology map for Harmonia's UI, agent runtime, durable state, integrations, media pipeline, and observability.
- [UI platform](https://docs.app.useharmonia.xyz/platform/ui/overview.md): How Harmonia presents deterministic workflow truth and bounded agent-generated surfaces.
- [Next.js](https://docs.app.useharmonia.xyz/platform/ui/nextjs.md): How Harmonia uses Next.js for its operator UI, authenticated API boundary, and deterministic workflow services.
- [Vercel AI SDK 7](https://docs.app.useharmonia.xyz/platform/ui/ai-sdk.md): How Harmonia uses AI SDK 7 for bounded, server-hydrated generative operator surfaces.
- [Agent platform](https://docs.app.useharmonia.xyz/platform/agents/overview.md): Strands cognition, AgentCore execution and evidence-bound memory.
- [Strands Agents SDK](https://docs.app.useharmonia.xyz/platform/agents/strands.md): Native request-scoped cognition with deterministic host authority.
- [Amazon Bedrock models](https://docs.app.useharmonia.xyz/platform/agents/bedrock.md): Exact default model identifiers and metering boundaries.
- [Noni writing runtime](https://docs.app.useharmonia.xyz/platform/agents/noni-runtime.md): Exact draft and artifact registrations, preloaded method and evidence boundary.
- [AgentCore Runtime](https://docs.app.useharmonia.xyz/platform/agents/agentcore.md): Managed cognition entrypoint and authenticated invocation envelope.
- [AgentCore Memory](https://docs.app.useharmonia.xyz/platform/agents/agentcore-memory.md): Native typed memory APIs with workspace-and-brand provenance.
- [Security and identity platform](https://docs.app.useharmonia.xyz/platform/security/overview.md): Operator identity, workload identity, and secret boundaries in Harmonia.
- [Cognito identity](https://docs.app.useharmonia.xyz/platform/security/cognito.md): Google federation with server-owned sessions.
- [AWS runtime roles](https://docs.app.useharmonia.xyz/platform/security/iam-service-accounts.md): Separate AWS task and managed-service roles with application-level authority checks.
- [AWS Secrets Manager](https://docs.app.useharmonia.xyz/platform/security/secret-manager.md): How Harmonia supplies provider credentials to ECS Fargate without placing secrets in code or client bundles.
- [Storage and messaging platform](https://docs.app.useharmonia.xyz/platform/data/overview.md): Durable state, asynchronous delivery, and binary asset storage in Harmonia.
- [DynamoDB](https://docs.app.useharmonia.xyz/platform/data/dynamodb.md): Durable tenant-scoped state and atomic authority.
- [SQS](https://docs.app.useharmonia.xyz/platform/data/sqs.md): Repeatable delivery with application-owned idempotency.
- [S3 assets](https://docs.app.useharmonia.xyz/platform/data/s3.md): Quarantine, immutable assets, and digest verification.
- [Runtime and automation platform](https://docs.app.useharmonia.xyz/platform/runtime/overview.md): How ECS Fargate and EventBridge Scheduler host and wake Harmonia's durable workflow.
- [ECS Fargate](https://docs.app.useharmonia.xyz/platform/runtime/fargate.md): Web, worker, and scanner containers.
- [EventBridge Scheduler](https://docs.app.useharmonia.xyz/platform/runtime/eventbridge.md): Durable wakeups for recovery and resident cycles.
- [Media platform](https://docs.app.useharmonia.xyz/platform/media/overview.md): Host-owned generation, composition and independent byte verification.
- [ffmpeg and HyperFrames](https://docs.app.useharmonia.xyz/platform/media/ffmpeg.md): Deterministic rendering under sealed production authority.
- [Generated media](https://docs.app.useharmonia.xyz/platform/media/generated-media.md): Native Canvas, Reel, Transcribe and ElevenLabs contracts and readiness.
- [Integration platform](https://docs.app.useharmonia.xyz/platform/integrations/overview.md): Official external APIs used for sources, operator access, calendars, signals, and publishing.
- [X API v2](https://docs.app.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.app.useharmonia.xyz/platform/integrations/telegram.md): How Harmonia exposes tenant-scoped job, status, and approval interactions through Telegram.
- [Google Calendar API](https://docs.app.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.app.useharmonia.xyz/platform/integrations/hacker-news-algolia.md): How Nova and proactive checks obtain current public startup-technology signals.
- [YouTube video sources](https://docs.app.useharmonia.xyz/platform/integrations/youtube.md): How Harmonia resolves authorized YouTube videos into evidence-grounded normalized sources.
- [Logging and monitoring platform](https://docs.app.useharmonia.xyz/platform/observability/overview.md): Correlation, traces, structured logs, metrics, and usage budgets across Harmonia.
- [OpenTelemetry](https://docs.app.useharmonia.xyz/platform/observability/opentelemetry.md): How Harmonia propagates and records privacy-bounded execution traces.
- [CloudWatch traces](https://docs.app.useharmonia.xyz/platform/observability/cloudwatch.md): Metadata-only distributed execution evidence.
- [Structured logging](https://docs.app.useharmonia.xyz/platform/observability/structured-logging.md): How Harmonia logs operational outcomes without leaking prompts, content, or credentials.
- [Monitoring and metrics](https://docs.app.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.app.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.app.useharmonia.xyz/operations/overview.md): Operate Harmonia through failure, recovery, approval, replay, observability, and deployment.
- [Bounded autonomy and operational KPIs](https://docs.app.useharmonia.xyz/operational-model.md): Where Harmonia reasons, where deterministic code controls execution, where humans retain authority, and how the demo is measured.
- [Operational control plane](https://docs.app.useharmonia.xyz/operational-control-plane.md): Operator attention, resumable live state, durable job controls, connector capabilities, and large-batch execution.
- [Failure and recovery reference](https://docs.app.useharmonia.xyz/failure-recovery.md): Typed failure categories, retry limits, escalation, replay, and fail-closed recovery behavior.
- [State ownership and retention](https://docs.app.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.app.useharmonia.xyz/record-replay.md): Capture, sanitize, review, and replay authenticated runs without fabricating evidence or mutating durable state.
- [How to respond to an operational alarm](https://docs.app.useharmonia.xyz/operations/incidents.md): Triage Harmonia alarms from persisted state, contain effects, and recover without replaying uncertain work.
- [Approvals & Audit](https://docs.app.useharmonia.xyz/approval-and-audit.md): The approval gate, idempotency receipts, and independent verification.
- [Governed resident autonomy](https://docs.app.useharmonia.xyz/resident-autonomy.md): Operate Heartbeat, Dream Cycle, Wakeup Call, experiments, and rollback without widening model authority.
- [Observability and trace lineage](https://docs.app.useharmonia.xyz/observability.md): W3C propagation, stage and agent spans, action lineage, privacy boundaries, and evidence correlation.
- [Deployment](https://docs.app.useharmonia.xyz/deployment.md): Deploy the isolated AWS edition with CDK after spending is authorized.
- [How to verify and stage a release](https://docs.app.useharmonia.xyz/operations/release.md): Create exact-commit evidence, scan locally built images, and hand a reviewed digest to the protected staging workflow.
- [How to run a backup restore drill](https://docs.app.useharmonia.xyz/operations/backup-restore.md): Restore the latest DynamoDB recovery point into an isolated table and retain the result for inspection.
- [How to rotate internal service tokens](https://docs.app.useharmonia.xyz/operations/secret-rotation.md): Rotate Harmonia's generated service tokens and replace every runtime that consumes them.
- [How to run the local load check](https://docs.app.useharmonia.xyz/operations/local-load.md): Measure a built Harmonia web process on loopback without contacting a hosted service.
- [Context and memory continuity](https://docs.app.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.app.useharmonia.xyz/reference/overview.md): Canonical contracts, routes, states, configuration, storage, authority, and evidence records.
- [Configuration](https://docs.app.useharmonia.xyz/configuration.md): AWS services, model selection, secrets, and explicit paid-capability gates.
- [Environment variable reference](https://docs.app.useharmonia.xyz/reference/environment.md): Index of Harmonia configuration domains and the source files that validate them.
- [Google Calendar sync reference](https://docs.app.useharmonia.xyz/google-calendar-reference.md): OAuth scope, API routes, event projection, persisted states, idempotency, errors, and verification behavior.
- [API routes reference](https://docs.app.useharmonia.xyz/reference/api-routes.md): The public operator, integration, and internal worker route families exposed by Harmonia.
- [Media upload reference](https://docs.app.useharmonia.xyz/reference/upload-media.md): Tenant-scoped upload sessions, source-rights declarations, completion, and source-registry handoff.
- [Job state machine reference](https://docs.app.useharmonia.xyz/reference/job-state-machine.md): Canonical Harmonia stages, gates, terminal states, and transition ownership.
- [Agent contracts reference](https://docs.app.useharmonia.xyz/reference/agent-contracts.md): Strict inputs, outputs, evidence requirements, and authority limits for every Harmonia specialist.
- [Effect contracts reference](https://docs.app.useharmonia.xyz/reference/effect-contracts.md): Commands, authorization, claims, idempotency, and terminal effect outcomes.
- [Error taxonomy reference](https://docs.app.useharmonia.xyz/reference/error-taxonomy.md): Normalized failure categories, retry rules, and safe public reporting.
- [DynamoDB data reference](https://docs.app.useharmonia.xyz/reference/dynamodb-data.md): Tenant hierarchy and durable record families used as Harmonia's workflow truth.
- [Campaigns and production planning](https://docs.app.useharmonia.xyz/reference/campaign-planning.md): Durable campaign, plan, item, policy, command and execution records.
- [Authority matrix reference](https://docs.app.useharmonia.xyz/reference/authority-matrix.md): Who may reason, decide, persist, schedule, execute, and verify in Harmonia.
- [Pricing and budget reference](https://docs.app.useharmonia.xyz/reference/pricing-budget.md): Versioned model pricing, reservations, observed usage, and paid-operation policy.
- [Receipts and verification reference](https://docs.app.useharmonia.xyz/reference/receipts-verification.md): Immutable execution evidence, independent read-back, and replay lineage.
- [How to capture AWS deployment evidence](https://docs.app.useharmonia.xyz/cloud-proof.md): Capture judge-visible proof of AgentCore Runtime, AgentCore Memory, ECS Fargate, DynamoDB, SQS, and correlated execution.
- [Authenticated vertical-slice evidence](https://docs.app.useharmonia.xyz/evidence-runbook.md): Fail-closed protocol for proving one real Harmonia run without exposing private content.
- [Glossary](https://docs.app.useharmonia.xyz/glossary.md): Shared vocabulary for Harmonia's agents, workflow, authority, evidence, and operations.