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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user