Agent-readiness kit (Project Rocky)

AGENTS.md

@@ -0,0 +1,64 @@
+# siren-python — Agent Instructions
+
+Read this file at the start of every session. It is deliberately thin: it tells
+you where the real context lives, not what the context is. Standards, patterns,
+and anti-patterns live in the Navigator knowledgebase, not here.
+
+## What This Repo Is
+
+Official Siren SDK for Python — records sales, refunds, referred visits, and
+custom events, verifies signed webhooks in a single constant-time call, and
+reconciles Siren's ledger with paginated readers. Python 3.9+ library on
+httpx, published to PyPI as `siren-sdk`; tested with pytest and respx.
+
+- **Initiative:** `siren` (declared in `navigator.yaml`)
+- **Repository:** `Novatorius/siren-python`
+
+## Before Coding: Load the KB Context
+
+Repo standards live in the Navigator KB, referenced from `knowledgeDependencies`
+in `navigator.yaml`. They are not in your training data.
+
+1. If `.claude/kb-context.md` exists, read it.
+2. If it doesn't, generate it, then read it:
+
+```bash
+navigator kb context
+```
+
+Do not skip this step. For targeted lookups afterwards:
+
+```bash
+navigator kb search "<topic>" --initiative=siren --json
+navigator kb show <id>
+```
+
+## Verification
+
+The `ci` block in `navigator.yaml` is the contract. Run its commands before and
+after every change and leave them green:
+
+```bash
+pip install -e ".[dev]"   # ci.setup
+pytest   # ci.test
+```
+
+What "done" means (PR audit, testing tiers, UAT proof) is defined in the KB:
+`global-definition-of-done`. Test-modification rules:
+`global-unit-testing-standards-modifying-existing-tests`. Both load via kb context.
+
+## Session End
+
+Journal early and often, not just at the end — journals are the update feed;
+discovery docs (Navigator sources) hold current state. Conventions live in the
+KB: `journaling-at-novatorius` and `discovery-process`. Quick path: the `/log`
+skill, or:
+
+```bash
+navigator journal submit "<summary>" "<narrative content>" \
+  --initiative=siren --tags=siren-python --json
+```
+
+If this session produced decisions or durable understanding, that is discovery —
+capture it per `discovery-process` (journal + charter drafts), don't let it
+evaporate into chat history.

CLAUDE.md

@@ -0,0 +1 @@
+Read AGENTS.md.

navigator.yaml

@@ -0,0 +1,15 @@
+initiative: siren
+ci:
+  setup: pip install -e ".[dev]"
+  test: pytest
+knowledgeDependencies:
+  - initiative: phpnomad
+    description: "Org-wide engineering doctrine"
+    critical:
+      - global-definition-of-done
+      - global-failure-and-logging-doctrine
+      - global-unit-testing-standards-modifying-existing-tests
+      - global-taxonomy-and-sdk-doctrine
+      - global-integration-testing-standards-introduction
+      - global-e2e-testing-standards-introduction
+      - global-pattern-decidability-doctrine