feat(protocol): add universal agent framework task specification
Drafts a task specification file `tasks/new/2026-0825.01.jul.story.protocol.universal-agent-framework-1945.md` outlining the extraction of the multi-agent orchestration workflow from Auth-Yes into a clean, reusable, repository-agnostic blueprint. This specification adheres to `tasks/GUIDELINES.md` and covers both a foundational architecture guide and a drop-in scaffolding template bundle. Co-authored-by: mrteye <1945243+mrteye@users.noreply.github.com>
This commit is contained in:
parent
f130b97838
commit
e54496b51f
@ -0,0 +1,79 @@
|
||||
# TASK METADATA
|
||||
|
||||
- **Target Files:** `docs/MULTI_AGENT_ORCHESTRATION_FRAMEWORK.md`,
|
||||
`template/tasks/`, `template/AGENTS.md`, `template/README-widgets.md`
|
||||
- **Core Objective:** Extract and formalize the Auth-Yes multi-agent
|
||||
orchestration workflow into a clean, reusable, repository-agnostic blueprint
|
||||
and template bundle.
|
||||
- **Dependencies:** None.
|
||||
- **Additional Important Notes:** This task must strictly decouple Auth-Yes
|
||||
runtime specifics (Deno, Rust, Valkey, ConnectRPC, Postgres) from the
|
||||
universal meta-process lifecycle.
|
||||
|
||||
---
|
||||
|
||||
### 2. Architectural Considerations & Risks
|
||||
|
||||
- **Risks:**
|
||||
- **Over-specialization:** The framework might inadvertently retain Auth-Yes
|
||||
specific terminology or technology assumptions, making it hard to adopt in
|
||||
non-TypeScript or non-monorepo environments (e.g., Python, Go).
|
||||
- **Tooling Overhead:** If the bootstrap template is too complex, developers
|
||||
might ignore it. The template bundle needs to be lightweight and purely
|
||||
markdown/process-driven.
|
||||
- **Alternatives:**
|
||||
- Instead of a manual template bundle, we could create an automated CLI (e.g.,
|
||||
an npm/npx or Deno script) to scaffold the framework. However, a pure
|
||||
markdown template bundle is more universal and easier to audit initially. We
|
||||
will stick with the documentation and template bundle as the primary
|
||||
deliverable for maximum portability.
|
||||
|
||||
### 3. Proposed Implementation
|
||||
|
||||
This task requires creating a two-tier deliverable to formalize the Multi-Agent
|
||||
Development & Ideation Protocol:
|
||||
|
||||
#### Phase 1: Foundational Architecture Guide
|
||||
|
||||
Draft a comprehensive standalone guide
|
||||
(`docs/MULTI_AGENT_ORCHESTRATION_FRAMEWORK.md`) that documents the philosophy
|
||||
and mechanics of the framework.
|
||||
|
||||
- **Universal Core Mechanics to Document:**
|
||||
- **4-Step Engineering Lifecycle:** The sequential pipeline (`plan` ──►
|
||||
`audit-1` ──► `do` ──► `audit-2`) and the out-of-band `debug` protocol.
|
||||
- **Dual-Mode Communication Pattern:** The taxonomy of Direct Execution
|
||||
Protocol (acting as the agent) vs. Dispatch Template (preparing a prompt for
|
||||
another agent).
|
||||
- **Strict Operating Gates:** The mandatory read-only first pass, dual-level
|
||||
deliberation, and explicit user approval before code edits.
|
||||
- **Kanban State Machine:** The directory progression for tracking state
|
||||
(`tasks/new/` ──► `tasks/wip/` ──► `tasks/complete/`).
|
||||
- **Semantic Task Metadata:** The strict naming schema and mandatory
|
||||
`# TASK METADATA` header.
|
||||
|
||||
#### Phase 2: Drop-in Scaffolding Template Bundle
|
||||
|
||||
Create a clean, reusable folder structure (`template/`) ready to be dropped into
|
||||
any target repository (Node, Go, Python, Rust, etc.).
|
||||
|
||||
- **Components to Scaffold:**
|
||||
- `template/tasks/`: A mirrored, repo-agnostic version of the Auth-Yes tasks
|
||||
directory, including `GUIDELINES.md`, `path.md`, `plan.md`, `audit-1.md`,
|
||||
`do.md`, `audit-2.md`, and `debug.md`.
|
||||
- `template/AGENTS.md`: A starter template for system guidelines, omitting
|
||||
Auth-Yes runtime specifics.
|
||||
- `template/README-widgets.md`: Markdown snippets for integrating the
|
||||
engineering lifecycle diagram and quick reference tables into a project's
|
||||
main README.
|
||||
|
||||
#### Phase 3: Decoupling and Purging "Auth-Yesisms"
|
||||
|
||||
During the extraction, explicitly strip all references to Auth-Yes
|
||||
infrastructure, including:
|
||||
|
||||
- Language/Runtime bindings: Deno 2, TypeScript, Rust `spire_ffi`, ConnectRPC,
|
||||
Valkey, PostgreSQL.
|
||||
- Project-specific paths: `sdk/`, `server/`, `ui/`, `scratch/`.
|
||||
- Domain specifics: `.atyg.org` wildcard cookie domains, Traefik ForwardAuth
|
||||
routing.
|
||||
Loading…
x
Reference in New Issue
Block a user