diff --git a/agentfield-package.yaml b/agentfield-package.yaml
new file mode 100644
index 0000000..a737174
--- /dev/null
+++ b/agentfield-package.yaml
@@ -0,0 +1,47 @@
+config_version: v1            # manifest schema version (omit = legacy v0)
+name: pr-af
+version: 0.1.0
+description: Opens draft pull requests from a task description
+author: Agent-Field
+
+entrypoint:
+  start: python -m pr_af.app
+  healthcheck: /health
+
+agent_node:
+  node_id: pr-af
+  default_port: 8004
+
+user_environment:
+  required:
+    - name: OPENROUTER_API_KEY
+      description: LLM provider key (OpenRouter)
+      type: secret
+      scope: global
+    # pr-af's core loop clones the target repo, pushes a branch, and opens a
+    # pull request — all need GitHub write access (see app.py / github/client.py).
+    # Required so setup prompts for it up front instead of failing mid-run.
+    - name: GH_TOKEN
+      description: GitHub token (repo scope) for cloning repos and opening pull requests
+      type: secret
+      scope: global
+  optional:
+    - name: AGENTFIELD_SERVER
+      description: Control-plane URL
+      default: http://localhost:8080
+    - name: AGENTFIELD_API_KEY
+      description: Control-plane API key (if auth is enabled)
+      type: secret
+      scope: global
+    - name: PR_AF_PROVIDER
+      description: Coding-agent harness provider
+      default: opencode
+    - name: PR_AF_MODEL
+      description: Model the harness uses
+      default: openrouter/moonshotai/kimi-k2.5
+    - name: PR_AF_MAX_COST_USD
+      description: Per-run cost ceiling (USD)
+      default: "2.0"
+    - name: PR_AF_MAX_DURATION_SECONDS
+      description: Per-run wall-clock ceiling (seconds)
+      default: "300"