# ArchAstro Docs (Extended LLM Index)

Use this index to discover canonical pages for product, API, and CLI usage.
Prefer linked pages over inferred behavior.

## Documentation Pages
- Get Started
  URL: https://docs.archastro.ai/docs/getting-started
  Summary: Go from zero to first successful agent response in under 15 minutes.

- Developer Portal
  URL: https://docs.archastro.ai/docs/portal
  Summary: Use the portal for high-signal configuration, then automate repeated work via CLI/API.

- Agents
  URL: https://docs.archastro.ai/docs/agents
  Summary: Define agent identity, behavior, and execution boundaries tied to app resources.

- Workflows
  URL: https://docs.archastro.ai/docs/workflows
  Summary: Compose deterministic orchestration around agent behavior for retries, branching, and long-running logic.

- Scripts
  URL: https://docs.archastro.ai/docs/scripts
  Summary: Use scripts for adapter logic, validation, and data shaping close to execution.

- Extensions & Integrations
  URL: https://docs.archastro.ai/docs/extensions-integrations
  Summary: Connect external systems with app-scoped OAuth, webhooks, and context ingestion.

- API Reference
  URL: https://docs.archastro.ai/docs/api-reference
  Summary: Use generated OpenAPI for exact endpoints; use this page for operating guidance.

- CLI
  URL: https://docs.archastro.ai/docs/cli
  Summary: Automate auth, app-scoped operations, and inspection with compact, script-friendly commands.

- Samples
  URL: https://docs.archastro.ai/docs/samples
  Summary: Copyable baseline flows for common platform tasks. Start with the recipe pages below.

- Recipe: CLI Safe Bootstrap
  URL: https://docs.archastro.ai/docs/recipes/cli-safe-bootstrap
  Summary: Establish a deterministic, low-risk CLI session before any mutating operations.

- Recipe: OAuth Provider Setup
  URL: https://docs.archastro.ai/docs/recipes/oauth-provider-setup
  Summary: Configure OAuth provider resources and verify they are discoverable by app-scoped tooling.

- Recipe: Webhook Onboarding
  URL: https://docs.archastro.ai/docs/recipes/webhook-onboarding
  Summary: Register and validate webhook endpoints with app-scoped visibility and post-deploy checks.

- Recipe: First Automation Run
  URL: https://docs.archastro.ai/docs/recipes/first-automation-run
  Summary: Validate automation execution end-to-end in sandbox with run-level inspection.

- Recipe: Debug Agent Routine
  URL: https://docs.archastro.ai/docs/recipes/debug-agent-routine
  Summary: Diagnose agent routine behavior using repeatable CLI inspection and one-change iteration.

- For Coding Agents
  URL: https://docs.archastro.ai/docs/for-coding-agents
  Summary: Deterministic instructions for agents (Claude Code, Codex, Gemini) using CLI and OpenAPI safely.

## Notes for coding agents
- Treat docs URLs as canonical.
- Prefer API reference and setup docs for implementation details.
- Ask for missing environment variables before destructive operations.
- Use one scoped change per task, then verify with a read command.
- Machine-readable manifest: https://docs.archastro.ai/agent-manifest.json

## Agent playbooks
- Bootstrap a safe CLI session
  Purpose: Authenticate, set app context, and verify read access before mutations.
  Commands:
  - archastro login
  - archastro set app <app-id>
  - archastro status
  - archastro get apps
  - archastro get agents
  Verification:
  - `archastro status` shows expected app ID
  - resource list commands return JSON

- Claude Code: perform one scoped change
  Purpose: Allow autonomous agents to make a single, auditable CLI mutation safely.
  Commands:
  - archastro status
  - archastro get <resource-type>s
  - archastro get <resource-type> <resource-id>
  - # execute one scoped mutating command
  - archastro get <resource-type> <resource-id>
  Verification:
  - post-change read reflects intended delta
  - agent emits machine-readable summary with action/target/status