docs: add AGENTS.md and fix agent role defs for deno-first project

- Add AGENTS.md with project overview, conventions, commands, and heritage notes
- Fix all npm→deno command references in coordinator, implementation-specialist, poc-specialist
- Fix project name in coordinator spawn template (@alkdev/operations→@alkdev/storage)
- Remove hub-specific content (future model, hub operations) from coordinator
- Add project-specific conventions to implementation-specialist (no comments, TypeBox, slow types, etc.)
- Add deno-specific review checks to code-reviewer
- Fix file path examples in implementation-specialist (packages/core→src/graphs)
- Update sdd_process.md to remove hub-specific references and architecture doc list
- Update architect examples to use storage component names
This commit is contained in:
2026-05-28 12:29:39 +00:00
parent 8c68dd6b07
commit 351fc98ec1
7 changed files with 141 additions and 54 deletions

View File

@@ -54,7 +54,7 @@ OpenCode spawns a NEW shell per command. The open-coordinator plugin auto-inject
```bash
# ✅ CORRECT — workdir is auto-injected
npm test
deno test --allow-all test/
# ✅ ALSO CORRECT — explicit workdir still works
bash({ command: "npm test", workdir: "/path/to/worktree" })
@@ -95,20 +95,23 @@ If blocked → Safe Exit (see below)
4. **Write tests** as needed
**File paths:** Always relative to worktree root
-`packages/core/src/mod.ts`
-`src/graphs/mod.ts`
- ❌ Absolute paths to the main repo (outside your worktree)
### 4. Self-Verify
```bash
# Run tests (adjust for project toolchain)
npm test
# Type check
deno check mod.ts src/graphs/mod.ts src/sqlite/mod.ts
# Check lint
npm run lint
# Lint
deno lint
# Verify changes
git diff --stat
# Run tests
deno test --allow-all test/
# Format check
deno fmt --check
```
Check each acceptance criterion in the task file.
@@ -179,6 +182,17 @@ When available, use memory tools to manage your context:
This is especially important for complex tasks that span many file operations.
## Project Conventions (@alkdev/storage)
Read `AGENTS.md` at project root for full details. Key rules:
1. **No comments in code** — Per project convention.
2. **TypeBox, not Zod** — Use `@alkdev/typebox` and `@alkdev/drizzlebox` for schema/validation.
3. **Explicit .ts extensions** — All imports must include the `.ts` extension (Deno convention).
4. **JSR slow types** — Drizzle's deeply inferred generics make explicit annotations impractical. Use `--allow-slow-types`. Do not annotate drizzle table definitions.
5. **Injectable clients** — `createSqliteDatabase(client)` takes a client, not env vars. No module-level side effects.
6. **Naming conventions** — TypeBox schemas: PascalCase (`NodeType`). Drizzle tables: camelCase (`graphTypes`). Drizzlebox schemas: PascalCase (`InsertGraph`).
## Key Principles
1. **Read first** - understand before implementing