# Curie

> Open-source, self-hostable platform that turns supported agents into co-workers in team workspaces. Start with Software Factory: delegate a GitHub issue and inspect a reviewed pull request or a clear failure reason. Bring supported existing skills and tools onto the same platform.

The CLI can be driven by a coding agent or a developer. Use released installation
paths for adoption; contributor builds are a separate journey. Read capability
status before promising a channel, model runtime, memory behavior, or control.

## Start here

- [README.md](README.md): product identity and three developer adoption paths.
- [docs/software-factory.md](docs/software-factory.md): Software Factory overview.
- [docs/guides/dark-factory-quickstart.md](docs/guides/dark-factory-quickstart.md): canonical issue-to-PR installation walkthrough.
- [docs/bring-your-agent.md](docs/bring-your-agent.md): supported compatibility and agent adoption.
- [examples/sre-bot/README.md](examples/sre-bot/README.md): SRE workflow, authority, and installation.
- [QUICKSTART.md](QUICKSTART.md): use-case chooser and scripted runner evaluation without Slack.
- [docs/capabilities.md](docs/capabilities.md): release status, limits, and future work.
- [docs/README.md](docs/README.md): navigation by developer intent.
- [docs/agent-install.md](docs/agent-install.md): unattended release install and result reporting.
- [docs/agents.md](docs/agents.md): verification contract for an agent driving Curie.

## Co-workers and administration

- [docs/co-workers.md](docs/co-workers.md): shared platform and observable co-worker behavior.
- [docs/administering-co-workers.md](docs/administering-co-workers.md): permissions, approvals, model roles, budgets, memory, audit, and stop controls.
- [docs/approvals.md](docs/approvals.md): approval route declaration, binding, authority, and resume.
- [docs/interfaces/memory/INTERFACE.md](docs/interfaces/memory/INTERFACE.md): memory scopes and credentials.
- [docs/guides/measuring-factory-outcomes.md](docs/guides/measuring-factory-outcomes.md): accepted outcomes, estimates, and human effort.
- [docs/operations.md](docs/operations.md): deployment, egress, credentials, upgrades, and operational limits.
- [SECURITY.md](SECURITY.md): security posture and reporting process.

## Build and adopt bundles

- [docs/adopting-a-bundle.md](docs/adopting-a-bundle.md): specific legacy-project conversion.
- [docs/your-first-slack-agent.md](docs/your-first-slack-agent.md): real workspace connection.
- [packages/plugin-format/README.md](packages/plugin-format/README.md): validated bundle shape.
- [examples/text-stats-engine/README.md](examples/text-stats-engine/README.md): tools as in-bundle stdio MCP servers.
- [examples/weather/](examples/weather/): starter skill.
- [docs/guides/repository-toolchain-in-the-managed-sandbox.md](docs/guides/repository-toolchain-in-the-managed-sandbox.md): supported repository dependencies and checks.
- [docs/local-model.md](docs/local-model.md): opt-in local Ollama and sizing.
- [docs/behavior-packs.md](docs/behavior-packs.md): opt-in interaction behavior.

## The parity ladder (skill -> local -> cluster)

The runner-only skill target, full local Compose platform, and Kubernetes cluster
use the same bundle format. Environment checks help catch deployment differences;
they do not guarantee identical model behavior in production.

- [README.md#quickstart](README.md#quickstart): local-to-cluster walkthrough.
- [README.md#which-target-do-i-want](README.md#which-target-do-i-want): target selection.
- [cli/README.md](cli/README.md): full command/flag reference.
- [docs/slack-local-runbook.md](docs/slack-local-runbook.md): local Slack test path.
- [docs/release-verification.md](docs/release-verification.md): release asset verification.

## Architecture and contribution

- [ARCHITECTURE.md](ARCHITECTURE.md): as-built components, flows, and verification status.
- [docs/interfaces.md](docs/interfaces.md): seam catalog and implementation contracts.
- [docs/adr/](docs/adr/): historical architecture decisions.
- [docs/vision.md](docs/vision.md): co-worker platform identity and commitments.
- [docs/onboarding.md](docs/onboarding.md): contributor onboarding from source.
- [CONTRIBUTING.md](CONTRIBUTING.md): contributor setup and checks.
- [AGENTS.md](AGENTS.md): operative repository instructions; docs/agents.md is for operating Curie.