Skip to content

feat(templates): add 9 dev-workflow starter templates - #6

Merged
evereq merged 2 commits into
developfrom
session/dev-workflow-templates
Aug 15, 2026
Merged

feat(templates): add 9 dev-workflow starter templates#6
evereq merged 2 commits into
developfrom
session/dev-workflow-templates

Conversation

@evereq

@evereq evereq commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

What

Adds an engineering-workflow tier of nine starter-* templates to the catalog:

Template Scope Role
Generalist TENANT one-off tasks that fit no specialist; routes to specialists
Senior Dev WORK ambiguous/cross-cutting/risky changes; trade-off judgment; teaching PRs
Planner WORK read-only implementation plans (touch points, ordering, risks) before code
Plan Executor WORK ships an approved plan exactly; stops and reports on divergence
Plan Reviewer WORK P0–P3 findings on plans before any code is written
Code Reviewer WORK P0–P3 findings on diffs; verify-before-report; read-only
Review Coordinator WORK fans review out to collaborator reviewers, dedupes, consolidates
Librarian WORK keeps wiki/docs in sync with shipped code via small PRs
Spec Writer TENANT structured interviews → reviewable specs with numbered goals

Each template ships the full eight-part catalog shape (agent.yml, SOUL.md, README, system + 3 task prompts, skills.yml, 9-file KB, icon, eval). manifest.json indexes all nine.

Notes for review

  • skills.yml entries reference forthcoming ever-works/skills slugs (plan, interview, update-wiki, analyze-branch-bugs, task-intake, …) — unknown slugs are wizard-ignored by design (schema doc).
  • Review Coordinator is written as the canonical consumer of the platform's upcoming Collaborator Agents mechanism (allow-listed sub-agent fan-out); its agent.yml sets canCreateAgents/canAssignTasks true.
  • Validation: local run of the validate.yml checks (ajv schema validation of all 21 agent.yml/skills.yml/eval files, path existence, slug uniqueness) is green, plus structural checks (SOUL eight sections, no frontmatter, kb 2×4 files, no emojis, no first-person voice).

🤖 Generated with Claude Code

evereq and others added 2 commits August 14, 2026 16:17
Adds the engineering-workflow tier to the catalog: generalist,
senior-dev, planner, plan-executor, plan-reviewer, code-reviewer,
review-coordinator, librarian, spec-writer.

Each template ships the full catalog shape: .works/agent.yml manifest,
SOUL.md personality contract, runtime system prompt + 3 Quick-Action
task prompts, skills.yml (referencing forthcoming ever-works/skills
slugs: plan, interview, update-wiki, analyze-branch-bugs, task-intake),
seeded KB (2 playbooks / 2 checklists / 2 templates / 2 examples),
icon, and a behavioral eval. manifest.json indexes all 9.

The Review Coordinator template is the canonical use case for the
platform's upcoming Collaborator Agents mechanism (it fans review
subtasks out to Code Reviewer / Plan Reviewer collaborators).

All 21 catalog templates validate against schema/ (ajv, local run of
the validate.yml checks) plus structural checks (SOUL sections, kb
completeness, no frontmatter, no emojis, no first-person voice).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The node -e script embedded in validate.yml had mangled template
literals ($+{...}+` instead of ${...}) — a parse-time SyntaxError,
so the workflow failed before validating anything. This PR is the
first pull_request event to exercise it.

Moves the validation logic to scripts/validate.js (same checks a-g,
correct syntax, runnable locally) and points the workflow step at it.
CONTRIBUTING now references the script instead of asking contributors
to paste the inline source.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@evereq
evereq merged commit 6d12685 into develop Aug 15, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant