> ## Documentation Index
> Fetch the complete documentation index at: https://docs.charmos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Guide

This guide covers the normal workflow for building Charm agents.

## Developer Workflow

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Initialize -> Configure -> Develop -> Validate -> Run -> Publish -> Observe
```

### 1. Initialize

Start from a template:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm init my-agent --template python
```

See [Build Your First Agent](/quickstart/first-app).

### 2. Configure

Edit `charm.yaml` to define identity, inputs, runtime, pricing, auth, and policies.

See [Configuration](/guides/manifest).

### 3. Develop

Write agent logic in the entry point declared in the manifest.

See [Local Execution](/guides/local-run).

### 4. Validate

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm validate .
```

See [Validation](/guides/validate).

### 5. Run

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm run . --input "Hello"
```

Use Docker mode to simulate the cloud runtime.

### 6. Publish

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm push .
```

See [Publishing](/guides/push).

### 7. Observe

Use Store, Studio, and CLI logs to inspect production behavior.

## Extending Charm

For adapters, runtimes, telemetry, memory, UI, templates, and renderers, start with [Extensibility Overview](/guides/extensibility).