# Starfire AI Documentation

> Official Starfire AI documentation for chat, projects, Knowledge, FORGE, agents, organizations, billing, the Developer Platform, Control Center, security, troubleshooting, and releases.

- [Starfire AI](https://aidocs.ethanbragdon.icu/index.md): Learn the Starfire AI platform architecture, major product surfaces, feature status model, and where to begin.
- [Quickstart](https://aidocs.ethanbragdon.icu/quickstart.md): Start using Starfire AI in minutes.
- [Platform Status & Terminology](https://aidocs.ethanbragdon.icu/getting-started/platform-status.md): Understand Starfire AI Alpha status, feature availability, rollout language, and documentation conventions.
- [Choose the Right Starfire Workflow](https://aidocs.ethanbragdon.icu/getting-started/choose-workflow.md): Decide whether a task belongs in Chat, Projects, Knowledge, Research, FORGE, Agents, or the Developer Platform.
- [Starfire AI Product Map](https://aidocs.ethanbragdon.icu/getting-started/product-map.md): See how Starfire AI workspace, Projects, Knowledge, FORGE, automation, billing, Developer Platform, and Control Center fit together.
- [First-Day Checklist](https://aidocs.ethanbragdon.icu/getting-started/first-day-checklist.md): A practical checklist for configuring a new Starfire AI account, choosing a workspace, creating a project, and understanding billing and security.
- [Account & Identity](https://aidocs.ethanbragdon.icu/account/identity-overview.md): Understand Starfire AI accounts, profiles, sessions, verification, and identity boundaries.
- [Authentication & Recovery](https://aidocs.ethanbragdon.icu/account/authentication.md): Learn Starfire AI sign-in, email verification, password recovery, OAuth, and account-protection flows.
- [Sessions & Devices](https://aidocs.ethanbragdon.icu/account/sessions-devices.md): Understand Starfire AI session persistence, device visibility, revocation, and account-security controls.
- [Profile & Account Settings](https://aidocs.ethanbragdon.icu/account/profile-settings.md): Manage Starfire AI profile information, timezone, account preferences, and context without affecting organization ownership.
- [Email Verification](https://aidocs.ethanbragdon.icu/account/email-verification.md): Complete Starfire AI email verification, understand why it matters, and recover from expired or invalid verification links.
- [Password Recovery](https://aidocs.ethanbragdon.icu/account/password-recovery.md): Reset a Starfire AI password safely, understand reset-token behavior, and review sessions after recovery.
- [Sign Out & Revoke Access](https://aidocs.ethanbragdon.icu/account/revoke-access.md): Sign out of Starfire AI, revoke specific sessions, review device access, and understand what is not revoked automatically.
- [Chat Overview](https://aidocs.ethanbragdon.icu/chat/overview.md): Learn the core Starfire AI conversation experience.
- [Models & Routing](https://aidocs.ethanbragdon.icu/chat/models-routing.md): Understand model availability, selection, and routing in Starfire AI.
- [Prompting Effectively](https://aidocs.ethanbragdon.icu/chat/prompting.md): Write clearer Starfire AI prompts with explicit goals, context, constraints, and output requirements.
- [Files & Context](https://aidocs.ethanbragdon.icu/chat/files-context.md): Understand how Starfire AI uses conversation attachments, project context, and persistent knowledge sources.
- [Search, Research & Citations](https://aidocs.ethanbragdon.icu/chat/search-research.md): Use Starfire AI search, deeper research workflows, citations, and source verification appropriately.
- [Conversation Management](https://aidocs.ethanbragdon.icu/chat/conversation-management.md): Create, rename, separate, and organize Starfire AI conversations so context stays focused and reusable.
- [Model Capability Reference](https://aidocs.ethanbragdon.icu/chat/model-capabilities.md): Compare the capability categories Starfire uses when deciding whether a model can handle reasoning, tools, vision, structured output, research, or FORGE.
- [Reasoning Modes](https://aidocs.ethanbragdon.icu/chat/reasoning-modes.md): Understand how Starfire AI reasoning settings affect model behavior, latency, cost, and workload fit.
- [Images & Attachments](https://aidocs.ethanbragdon.icu/chat/images-attachments.md): Use images and temporary file attachments in Starfire AI conversations and understand capability, context, and privacy boundaries.
- [Long Conversations & Context Limits](https://aidocs.ethanbragdon.icu/chat/long-conversations.md): Understand how long chat histories interact with model context windows, retrieval, summarization, and project organization.
- [Projects](https://aidocs.ethanbragdon.icu/projects/overview.md): Use Starfire AI projects as durable workspaces for conversations, files, knowledge, artifacts, and project context.
- [Project OS](https://aidocs.ethanbragdon.icu/projects/project-os.md): Understand the Project OS model for persistent context, ownership, resources, and long-running Starfire AI work.
- [Knowledge](https://aidocs.ethanbragdon.icu/knowledge/overview.md): Build persistent Starfire AI reference collections from files, repositories, indexed sources, and retrieval.
- [RAG & Retrieval](https://aidocs.ethanbragdon.icu/knowledge/rag-retrieval.md): Understand Starfire AI retrieval-augmented generation, chunking, embeddings, reranking, and source selection.
- [Repository Knowledge](https://aidocs.ethanbragdon.icu/knowledge/repositories.md): Use repositories as structured Starfire AI knowledge for code search, architecture understanding, and FORGE workflows.
- [Create & Manage Projects](https://aidocs.ethanbragdon.icu/projects/create-manage.md): Create Starfire AI projects, choose ownership context, manage project metadata, and organize long-running work.
- [Project Instructions & Context](https://aidocs.ethanbragdon.icu/projects/instructions-context.md): Write durable project instructions, separate them from task prompts, and understand how Starfire selects project context.
- [Knowledge Source Ingestion](https://aidocs.ethanbragdon.icu/knowledge/source-ingestion.md): Understand the lifecycle from file or source upload through extraction, chunking, embeddings, indexing, and retrieval readiness.
- [Manage Knowledge Sources](https://aidocs.ethanbragdon.icu/knowledge/source-management.md): Update, refresh, remove, and organize Knowledge sources while preserving ownership, permissions, and index health.
- [Debug Knowledge Retrieval](https://aidocs.ethanbragdon.icu/knowledge/retrieval-debugging.md): Diagnose why Starfire AI did not retrieve an expected Knowledge source, chunk, repository file, or citation.
- [Repository Sync & Refresh](https://aidocs.ethanbragdon.icu/knowledge/repository-sync.md): Keep repository-backed Knowledge and FORGE context aligned with the correct branch, revision, permissions, and project state.
- [Project Ownership & Access](https://aidocs.ethanbragdon.icu/projects/ownership-access.md): Understand personal vs organization project ownership, resource access, billing context, and ownership transfer considerations.
- [Project Lifecycle](https://aidocs.ethanbragdon.icu/projects/lifecycle.md): Manage a Starfire AI project from creation through active work, maintenance, completion, archive, and deletion.
- [FORGE](https://aidocs.ethanbragdon.icu/forge/overview.md): Understand Starfire AI FORGE, the software creation system for planning, building, validating, repairing, and packaging projects.
- [Build Mode](https://aidocs.ethanbragdon.icu/forge/build-mode.md): Follow the Starfire FORGE build lifecycle from planning through file creation, validation, repair, and artifact packaging.
- [Build & Repair Engine](https://aidocs.ethanbragdon.icu/forge/build-repair.md): Understand how FORGE validates generated software, interprets failures, and performs targeted repair attempts.
- [Repository Intelligence](https://aidocs.ethanbragdon.icu/forge/repository-intelligence.md): Ground FORGE planning, generation, and repair in the structure and conventions of an existing repository.
- [Artifacts](https://aidocs.ethanbragdon.icu/forge/artifacts.md): Understand Starfire AI build artifacts, packaging, metadata, checksums, ownership, downloads, and retention.
- [Start a FORGE Build](https://aidocs.ethanbragdon.icu/forge/start-build.md): Prepare requirements, choose context, start a Starfire FORGE build, and understand what happens after submission.
- [Write Better Build Requirements](https://aidocs.ethanbragdon.icu/forge/build-requirements.md): Define FORGE goals, constraints, acceptance criteria, validation requirements, and protected interfaces before a build starts.
- [FORGE Build States](https://aidocs.ethanbragdon.icu/forge/build-states.md): Reference the FORGE build lifecycle, terminal states, waiting states, and what users or operators should do at each stage.
- [Code Workspace](https://aidocs.ethanbragdon.icu/forge/code-workspace.md): Understand the temporary FORGE filesystem, project snapshot, file operations, workspace limits, and relationship to packaged artifacts.
- [Validation & Validators](https://aidocs.ethanbragdon.icu/forge/validation.md): Understand FORGE validation stages, validator types, success criteria, unsupported validation, and how results affect packaging.
- [Modify Existing Projects](https://aidocs.ethanbragdon.icu/forge/existing-projects.md): Use FORGE safely against an existing codebase by preserving public interfaces, repository patterns, validation commands, and source revision.
- [Dependencies & Build Environment](https://aidocs.ethanbragdon.icu/forge/dependencies-environment.md): Understand how FORGE handles project dependencies, manifests, environment assumptions, package installation, and reproducibility.
- [Download & Verify Artifacts](https://aidocs.ethanbragdon.icu/forge/download-artifacts.md): Download FORGE outputs, inspect artifact metadata, verify checksums, understand retention, and preserve important builds.
- [FORGE Limits & Best Practices](https://aidocs.ethanbragdon.icu/forge/limits-best-practices.md): Design FORGE jobs that fit workspace, runtime, concurrency, validation, artifact, and credit limits without sacrificing reliability.
- [Custom Agents](https://aidocs.ethanbragdon.icu/agents/overview.md): Create reusable AI agents with specialized instructions and purpose.
- [Writing Agent Instructions](https://aidocs.ethanbragdon.icu/agents/instructions.md): Design clear, reliable instructions for custom Starfire AI agents.
- [Tasks & Workflows](https://aidocs.ethanbragdon.icu/agents/tasks-workflows.md): Understand Starfire AI task execution, multi-step workflows, agent participation, budgets, and runtime state.
- [Schedules & Watchers](https://aidocs.ethanbragdon.icu/agents/schedules-watchers.md): Understand time-based and condition-based Starfire AI automation concepts, execution boundaries, and notification behavior.
- [Approvals & Memory](https://aidocs.ethanbragdon.icu/agents/approvals-memory.md): Understand Starfire AI approval gates, human oversight, persistent memory, and automation boundaries.
- [Create a Custom Agent](https://aidocs.ethanbragdon.icu/agents/create-agent.md): Create, scope, test, and save a reusable Starfire AI agent with durable instructions and appropriate capabilities.
- [Agent Tools & Permissions](https://aidocs.ethanbragdon.icu/agents/tools-permissions.md): Give Starfire AI agents only the tools, project context, Knowledge, and runtime permissions required for their role.
- [Test & Evaluate Agents](https://aidocs.ethanbragdon.icu/agents/testing.md): Evaluate Starfire AI agents against normal, ambiguous, adversarial, missing-context, tool, and permission cases before broader use.
- [Agent Run History & Budgets](https://aidocs.ethanbragdon.icu/agents/run-history-budgets.md): Understand agent execution history, model/tool usage, credit budgets, duration limits, and how to investigate failed or expensive runs.
- [Approval Workflows](https://aidocs.ethanbragdon.icu/agents/approval-workflows.md): Configure and operate human approval gates for sensitive Starfire AI workflow steps without turning a missing response into implicit authorization.
- [Organizations](https://aidocs.ethanbragdon.icu/organizations/overview.md): Understand organizations, shared administration, members, and organization-level controls.
- [Members & Roles](https://aidocs.ethanbragdon.icu/organizations/members-roles.md): Manage organization membership, invitations, roles, and permission boundaries.
- [Permissions & Policies](https://aidocs.ethanbragdon.icu/organizations/permissions-policies.md): Understand organization roles, effective permissions, feature policy, and access boundaries in Starfire AI.
- [Organization Projects & Knowledge](https://aidocs.ethanbragdon.icu/organizations/projects-knowledge.md): Understand organization-owned projects, Knowledge sources, shared context, and resource continuity.
- [Create an Organization](https://aidocs.ethanbragdon.icu/organizations/create-organization.md): Create a Starfire AI organization, establish ownership, configure the initial team, and avoid common personal-vs-team ownership mistakes.
- [Invitations & Offboarding](https://aidocs.ethanbragdon.icu/organizations/invitations-offboarding.md): Invite members safely, handle expired invitations, change roles, and offboard members without losing organization-owned resources.
- [Organization Role Matrix](https://aidocs.ethanbragdon.icu/organizations/role-matrix.md): Compare conceptual Starfire AI organization roles and use least privilege when assigning membership access.
- [Seats & Membership Capacity](https://aidocs.ethanbragdon.icu/organizations/seats.md): Understand how Starfire AI organization seats relate to invitations, active members, Business plans, and billing.
- [Project & Knowledge Access](https://aidocs.ethanbragdon.icu/organizations/project-access.md): Control organization member access to projects, Knowledge, repositories, artifacts, and related team resources.
- [Organization Policy Reference](https://aidocs.ethanbragdon.icu/organizations/policy-reference.md): Reference the organization policy categories that can affect models, FORGE, Research, files, Knowledge, developer access, and shared usage.
- [Billing & Plans](https://aidocs.ethanbragdon.icu/account/billing.md): Understand Starfire AI plans, subscriptions, billing accounts, and Stripe-backed billing.
- [Credits & Metering](https://aidocs.ethanbragdon.icu/billing/credits-metering.md): Understand Starfire AI credit accounting, usage categories, allowances, ceilings, and organization-aware metering.
- [Subscriptions & Stripe](https://aidocs.ethanbragdon.icu/billing/subscriptions-stripe.md): Understand Starfire AI subscription provisioning, Stripe customer linkage, webhooks, reconciliation, plan changes, and customer portal behavior.
- [Organization Billing](https://aidocs.ethanbragdon.icu/billing/organization-billing.md): Understand Starfire AI organization billing accounts, seats, shared credits, usage ownership, and subscription context.
- [Checkout & Provisioning Lifecycle](https://aidocs.ethanbragdon.icu/billing/checkout-lifecycle.md): Follow Starfire AI checkout from billing context selection through Stripe customer linkage, payment, webhook processing, reconciliation, and entitlements.
- [Upgrades & Downgrades](https://aidocs.ethanbragdon.icu/billing/plan-changes.md): Understand how Starfire AI upgrades, downgrades, seat changes, proration, entitlements, and billing reconciliation fit together.
- [Cancellation & Renewal](https://aidocs.ethanbragdon.icu/billing/cancellation-renewal.md): Understand Starfire AI subscription renewal, cancellation timing, entitlement changes, and what happens to stored resources after a plan ends.
- [Failed Payments & Billing Holds](https://aidocs.ethanbragdon.icu/billing/failed-payments.md): Understand how Starfire AI handles payment failures, retry/recovery state, billing holds, and product access without confusing billing with account security.
- [Customer Portal & Invoices](https://aidocs.ethanbragdon.icu/billing/customer-portal-invoices.md): Use the Stripe-backed customer portal for supported payment methods, invoices, subscription actions, and billing history.
- [Credit Lifecycle](https://aidocs.ethanbragdon.icu/billing/credit-lifecycle.md): Understand Starfire AI included, bonus, purchased, organization, period-based, and hard-ceiling credit behavior.
- [Developer Platform](https://aidocs.ethanbragdon.icu/developers/overview.md): Understand Starfire AI developer access, credentials, metering, and platform integration concepts.
- [API Access & Credentials](https://aidocs.ethanbragdon.icu/developers/api-access.md): Manage Starfire AI API keys, service accounts, scopes, and secure credential practices.
- [API Architecture & Versioning](https://aidocs.ethanbragdon.icu/developers/api-architecture.md): Understand the Starfire AI v1 API resource model, compatibility surface, native APIs, request IDs, and versioning policy.
- [Responses & Runs](https://aidocs.ethanbragdon.icu/developers/responses-runs.md): Understand Starfire-native responses, long-running runs, cancellation, status, and event streaming concepts.
- [Builds, Files & Artifacts](https://aidocs.ethanbragdon.icu/developers/build-files-artifacts.md): Understand the Starfire Developer Platform resource model for FORGE builds, files, packaged artifacts, and downloads.
- [Knowledge & Research APIs](https://aidocs.ethanbragdon.icu/developers/knowledge-research.md): Understand the Starfire Developer Platform model for knowledge bases, retrieval queries, embeddings, research runs, and cited reports.
- [Rate Limits & Errors](https://aidocs.ethanbragdon.icu/developers/rate-limits-errors.md): Understand Starfire AI developer quotas, request identifiers, error categories, and resilient client behavior.
- [Webhooks](https://aidocs.ethanbragdon.icu/developers/webhooks.md): Receive asynchronous Starfire AI events, understand delivery attempts, retries, event identifiers, and webhook ownership.
- [Applications & Service Accounts](https://aidocs.ethanbragdon.icu/developers/applications-service-accounts.md): Model durable Starfire AI integrations around applications, organization ownership, non-human identities, and scoped access.
- [API Logs & Usage](https://aidocs.ethanbragdon.icu/developers/logs-usage.md): Use Starfire AI developer logs, request IDs, latency, model usage, credits, and endpoint-level reporting to operate integrations.
- [SDKs, OpenAPI & Playground](https://aidocs.ethanbragdon.icu/developers/sdk-openapi.md): Understand the Starfire AI OpenAPI contract, SDK direction, interactive playground, and code-generation workflow.
- [Developer API Quickstart](https://aidocs.ethanbragdon.icu/developers/quickstart.md): Prepare a Starfire AI developer application, create a scoped credential, make a first v1 request, and capture request IDs safely.
- [Authentication & Scope Reference](https://aidocs.ethanbragdon.icu/developers/authentication-scopes.md): Reference Starfire AI developer authentication, bearer credentials, scope design, rotation, revocation, and organization ownership.
- [Models API Reference](https://aidocs.ethanbragdon.icu/developers/models-api.md): Reference the Starfire AI models resource and the capability metadata applications should use before choosing a route.
- [Chat Completions Compatibility](https://aidocs.ethanbragdon.icu/developers/chat-completions.md): Understand the Starfire AI OpenAI-compatible chat-completions surface, when to use it, and when to choose Starfire-native Responses instead.
- [Responses API Reference](https://aidocs.ethanbragdon.icu/developers/responses-api.md): Reference Starfire-native response creation, model input, reasoning/tool options, streaming, usage, and transition to long-running runs.
- [Runs API Reference](https://aidocs.ethanbragdon.icu/developers/runs-api.md): Reference Starfire AI long-running run creation, status, cancellation, terminal states, event streaming, and webhook completion patterns.
- [FORGE Builds API Reference](https://aidocs.ethanbragdon.icu/developers/builds-api.md): Reference the Starfire FORGE build resource, asynchronous build states, repository/project context, cancellation, validation, and artifact results.
- [Files & Artifacts API Reference](https://aidocs.ethanbragdon.icu/developers/files-artifacts-api.md): Reference Starfire AI file upload/metadata concepts and durable artifact listing, metadata, download, ownership, and retention behavior.
- [Knowledge API Reference](https://aidocs.ethanbragdon.icu/developers/knowledge-api.md): Reference Starfire AI knowledge-base resources, source ingestion, indexing state, retrieval queries, permissions, and project or organization ownership.
- [Research API Reference](https://aidocs.ethanbragdon.icu/developers/research-api.md): Reference Starfire AI research jobs, asynchronous status, source collection, report results, citation metadata, limits, and project ownership.
- [Webhook Event Reference](https://aidocs.ethanbragdon.icu/developers/webhook-events.md): Reference the Starfire AI webhook event families for runs, builds, research, artifacts, files, billing, and usage threshold notifications.
- [Idempotency & Pagination](https://aidocs.ethanbragdon.icu/developers/idempotency-pagination.md): Build reliable Starfire AI API clients using retry-safe state-changing requests and pagination patterns for large resource collections.
- [Embeddings API Reference](https://aidocs.ethanbragdon.icu/developers/embeddings-api.md): Understand Starfire AI embedding resources, model eligibility, input batching, vector metadata, metering, and the difference between embeddings and managed Knowledge.
- [Control Center](https://aidocs.ethanbragdon.icu/admin/control-center.md): Operate Starfire AI through the platform administration and observability Control Center.
- [Users & Identity](https://aidocs.ethanbragdon.icu/admin/users.md): Manage Starfire AI users, identity state, access, plans, and account context.
- [Model Administration](https://aidocs.ethanbragdon.icu/admin/models.md): Manage model availability, synchronization, and platform model controls.
- [Incidents](https://aidocs.ethanbragdon.icu/admin/incidents.md): Create, update, and track Starfire AI operational incidents and timelines.
- [System Health & Diagnostics](https://aidocs.ethanbragdon.icu/admin/system-health.md): Use Starfire AI health, diagnostics, and observability data during operations.
- [RBAC & Support Mode](https://aidocs.ethanbragdon.icu/admin/rbac-support.md): Understand Starfire AI administrator roles, granular permissions, sensitive-operation controls, and safer support access.
- [Organization Administration](https://aidocs.ethanbragdon.icu/admin/organizations.md): Operate Starfire AI organizations, memberships, seats, projects, billing context, usage, Knowledge, and policy from Control Center.
- [Providers, Routing & Fallbacks](https://aidocs.ethanbragdon.icu/admin/models-routing.md): Operate Starfire AI provider health, model routes, fallbacks, routing constraints, and route simulation from Control Center.
- [Intelligence Operations](https://aidocs.ethanbragdon.icu/admin/intelligence.md): Operate Starfire AI runs, research, FORGE builds, artifacts, Knowledge, retrieval, embeddings, search, and tools from Control Center.
- [Billing Administration](https://aidocs.ethanbragdon.icu/admin/billing.md): Operate Starfire AI customers, subscriptions, plans, credits, usage, invoices, failed payments, costs, and reconciliation from Control Center.
- [Developer Platform Administration](https://aidocs.ethanbragdon.icu/admin/developer-platform.md): Operate Starfire AI API keys, applications, webhooks, developer usage, quotas, logs, failures, and abuse signals from Control Center.
- [Security & Audit Operations](https://aidocs.ethanbragdon.icu/admin/security-audit.md): Investigate Starfire AI sessions, devices, access events, admin actions, API abuse, rate limits, risk signals, and audit history.
- [Platform Configuration](https://aidocs.ethanbragdon.icu/admin/configuration.md): Manage Starfire AI dynamic feature, plan, limit, tool, model, registration, storage, billing, research, build, and maintenance settings.
- [User Investigation Runbook](https://aidocs.ethanbragdon.icu/admin/user-investigation.md): Investigate Starfire AI user access, plan, organization, session, feature, model, usage, and security issues in a consistent order.
- [Account States & Restrictions](https://aidocs.ethanbragdon.icu/admin/account-states.md): Reference Starfire AI administrative account states, narrow feature restrictions, reasons, verification, and recovery procedures.
- [Session Security Runbook](https://aidocs.ethanbragdon.icu/admin/session-security-runbook.md): Investigate lost devices, suspicious sessions, account compromise reports, revocation, and related developer credentials from Control Center.
- [Credit Adjustment Runbook](https://aidocs.ethanbragdon.icu/admin/credit-adjustments.md): Apply Starfire AI credit bonuses, allowance corrections, ceilings, and support adjustments without hiding billing or metering defects.
- [Model Publishing Runbook](https://aidocs.ethanbragdon.icu/admin/model-publishing.md): Validate and publish a Starfire AI model safely across provider mapping, capabilities, limits, plan eligibility, routing, fallback, and metering.
- [Provider Health Runbook](https://aidocs.ethanbragdon.icu/admin/provider-health.md): Investigate Starfire AI model or search provider degradation using health, latency, errors, rate limits, routing, and incident scope.
- [Routing Simulator](https://aidocs.ethanbragdon.icu/admin/routing-simulator.md): Use Starfire AI routing simulation to test model/provider selection decisions without sending a real user workload.
- [FORGE Operations Runbook](https://aidocs.ethanbragdon.icu/admin/forge-operations.md): Operate Starfire AI FORGE queues, builds, validation, repair loops, artifacts, workers, and systemic failures from Control Center.
- [Knowledge Operations Runbook](https://aidocs.ethanbragdon.icu/admin/knowledge-operations.md): Operate Starfire AI extraction, indexing, embeddings, stale sources, retrieval failures, and Knowledge worker health from Control Center.
- [Billing Reconciliation Runbook](https://aidocs.ethanbragdon.icu/admin/billing-reconciliation.md): Reconcile Starfire AI BillingAccount, Stripe customer, subscription, price mapping, entitlements, credits, and organization seats without creating duplicate state.
- [Feature Flag Operations](https://aidocs.ethanbragdon.icu/admin/feature-flags.md): Stage Starfire AI capabilities by environment, plan, organization, cohort, or user without confusing rollout with entitlement or permission.
- [Maintenance Mode Runbook](https://aidocs.ethanbragdon.icu/admin/maintenance-mode.md): Use Starfire AI maintenance mode deliberately, coordinate incidents and communication, verify recovery, and avoid leaving the platform in partial maintenance state.
- [Incident Response Runbook](https://aidocs.ethanbragdon.icu/admin/incident-response.md): Detect, scope, mitigate, communicate, monitor, resolve, and review Starfire AI platform incidents using component health and timelines.
- [Security Overview](https://aidocs.ethanbragdon.icu/security/overview.md): Understand Starfire AI access boundaries, credential safety, and operational security practices.
- [Data & Privacy](https://aidocs.ethanbragdon.icu/security/data-privacy.md): Understand data-handling considerations when using Starfire AI.
- [Account Security](https://aidocs.ethanbragdon.icu/security/account-security.md): Protect Starfire AI account access through verification, session awareness, recovery, device review, and credential hygiene.
- [Developer Security](https://aidocs.ethanbragdon.icu/security/developer-security.md): Secure Starfire AI API keys, applications, service accounts, webhooks, scopes, and developer access boundaries.
- [Administrator Security](https://aidocs.ethanbragdon.icu/security/admin-security.md): Protect Starfire AI Control Center access through least privilege, auditability, support boundaries, and careful handling of sensitive operations.
- [Secrets & Credential Handling](https://aidocs.ethanbragdon.icu/security/secrets-credentials.md): Handle passwords, API keys, webhook secrets, provider credentials, private keys, and environment secrets safely across Starfire AI.
- [Data Classification Guidance](https://aidocs.ethanbragdon.icu/security/data-classification.md): Classify information before placing it into Starfire AI chats, Projects, Knowledge, artifacts, organizations, or developer integrations.
- [Security Incident Response](https://aidocs.ethanbragdon.icu/security/security-incident-response.md): Respond to exposed credentials, suspicious sessions, compromised developer integrations, or organization access concerns in Starfire AI.
- [Starfire AI Glossary](https://aidocs.ethanbragdon.icu/reference/glossary.md): Definitions for the core terms used across Starfire AI, FORGE, Knowledge, automation, billing, and the Developer Platform.
- [Status & Lifecycle Reference](https://aidocs.ethanbragdon.icu/reference/statuses.md): Reference for the lifecycle states used by Starfire AI accounts, runs, FORGE builds, incidents, indexing, and automation.
- [Resource Identifier Reference](https://aidocs.ethanbragdon.icu/reference/resource-identifiers.md): Understand how Starfire AI resource identifiers are used across support, APIs, builds, artifacts, billing, and diagnostics.
- [Limits & Quotas Reference](https://aidocs.ethanbragdon.icu/reference/limits-quotas.md): Understand the categories of Starfire AI limits, where effective values come from, and how to diagnose limit-related failures.
- [Permission Model Reference](https://aidocs.ethanbragdon.icu/reference/permissions-matrix.md): Compare personal, organization, developer, and platform-administrator permission boundaries across Starfire AI.
- [Error Taxonomy](https://aidocs.ethanbragdon.icu/reference/errors.md): Understand Starfire AI error categories, what they mean, what should be retried, and what information to capture for support.
- [Feature Availability Model](https://aidocs.ethanbragdon.icu/reference/feature-availability.md): Understand how plan, rollout, organization policy, model capability, and administrator configuration determine whether a Starfire AI feature is usable.
- [Common Issues](https://aidocs.ethanbragdon.icu/troubleshooting/common-issues.md): Troubleshoot common Starfire AI chat, account, organization, and model problems.
- [Billing Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/billing.md): Resolve Starfire AI plan, Stripe, subscription, provisioning, and billing-account issues.
- [Authentication Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/authentication.md): Troubleshoot Starfire AI sign-in, verification, password reset, OAuth, session, and account-state issues.
- [FORGE, Research & Knowledge Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/forge-research.md): Troubleshoot Starfire AI builds, artifacts, research runs, Knowledge indexing, retrieval, and long-running job failures.
- [Developer API Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/developer-api.md): Troubleshoot Starfire AI developer credentials, permissions, quotas, request failures, runs, webhooks, and API usage.
- [Chat & Model Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/chat-models.md): Troubleshoot missing models, failed sends, streaming interruptions, tool failures, context errors, and model-specific behavior in Starfire AI.
- [Organization Access Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/organization-access.md): Troubleshoot missing organizations, invitations, roles, seats, project permissions, policies, and personal-vs-team context.
- [Files & Knowledge Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/files-knowledge.md): Troubleshoot Starfire AI uploads, extraction, indexing, stale sources, permissions, retrieval, and repository-backed Knowledge.
- [Artifact Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/artifacts.md): Troubleshoot missing, failed, expired, corrupt, inaccessible, or incomplete Starfire AI FORGE artifacts and downloads.
- [Performance & Mobile Troubleshooting](https://aidocs.ethanbragdon.icu/troubleshooting/performance-mobile.md): Troubleshoot Starfire AI slow rendering, long conversations, mobile navigation, streaming UI, browser memory, and client-specific performance issues.
- [Alpha 1.6.2 — FORGE](https://aidocs.ethanbragdon.icu/releases/alpha-1-6-2.md): Release architecture for Starfire AI Alpha 1.6.2 FORGE: creation, Knowledge, Research, Control Center, and Developer Platform foundations.
- [Alpha 1.6.3 — NEXUS](https://aidocs.ethanbragdon.icu/releases/alpha-1-6-3.md): Deep release guide to Starfire AI Alpha 1.6.3 NEXUS: frontend, identity, Organizations 3.0, Billing 4.0, automation, Control Center 4.0, and Developer Platform expansion.

## Optional

- [Open Starfire AI](https://ai.ethanbragdon.icu)