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:
@@ -2,10 +2,10 @@
|
||||
|
||||
## Overview
|
||||
|
||||
This document defines the SDD process for the alk.dev project. It leverages:
|
||||
- **Operation registry + call protocol** for typed, composable tool invocation
|
||||
- **Hub coordination operations** (`coord.spawn`, `coord.status`, `coord.message`, etc.) for parallel worktree/session orchestration
|
||||
- **OpenCode CLI** as the agent execution environment (via the open-coordinator plugin as stopgap, transitioning to native hub operations)
|
||||
This document defines the SDD process for the @alkdev/storage package. It leverages:
|
||||
- **OpenCode CLI** as the agent execution environment
|
||||
- **Open-coordinator plugin** for worktree management and parallel session orchestration
|
||||
- **Structured task graphs** with dependency analysis and safe exit protocols
|
||||
|
||||
## Core Principles
|
||||
|
||||
@@ -473,29 +473,16 @@ State moves from in-process tracking to Postgres `mappings` table. The open-coor
|
||||
|
||||
docs/
|
||||
├── architecture/
|
||||
│ ├── hub-architecture.md
|
||||
│ ├── call-graph.md
|
||||
│ ├── spoke-runner.md
|
||||
│ ├── operations.md
|
||||
│ ├── mcp-server.md
|
||||
│ ├── coordination.md
|
||||
│ ├── storage/ # Decomposed: README.md, table-reference.md, per-domain schema files, tasks.md
|
||||
│ │ └── (ADRs in decisions/)
|
||||
│ ├── agent-sessions.md
|
||||
│ ├── pubsub-redis.md
|
||||
│ └── infrastructure.md
|
||||
│ └── storage/ # Decomposed: README.md, table-reference.md, per-domain schema files
|
||||
│ └── (ADRs in decisions/)
|
||||
├── sdd_process.md # This document
|
||||
└── decisions/ # ADRs
|
||||
|
||||
tasks/
|
||||
├── architecture/
|
||||
│ └── auth-design.md
|
||||
│ └── ...
|
||||
├── implementation/
|
||||
│ ├── storage/
|
||||
│ │ ├── tasks-table.md
|
||||
│ │ └── migrations.md
|
||||
│ └── auth/
|
||||
│ └── oauth-flow.md
|
||||
│ └── ...
|
||||
└── (taskgraph validates & analyzes dependency graph)
|
||||
|
||||
.worktrees/ # Created by coordinator
|
||||
|
||||
Reference in New Issue
Block a user