@goodtek/vibeops 0.7.22 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/README.md +51 -380
  3. package/dist/bootstrap/installer.js +42 -20
  4. package/dist/bootstrap/manifest.js +23 -3
  5. package/dist/cli.js +69 -154
  6. package/dist/commands/init.js +279 -114
  7. package/dist/commands/llm.js +177 -0
  8. package/dist/commands/status.js +181 -8
  9. package/dist/commands/task-add.js +89 -162
  10. package/dist/commands/task-done.js +112 -73
  11. package/dist/lib/config.js +77 -113
  12. package/dist/lib/env.js +32 -0
  13. package/dist/lib/git-config.js +21 -0
  14. package/dist/lib/git-host.js +12 -0
  15. package/dist/lib/git-policy.js +67 -0
  16. package/dist/lib/git-remote.js +108 -0
  17. package/dist/lib/git.js +44 -1
  18. package/dist/lib/init-clients.js +55 -0
  19. package/dist/lib/llm-complete.js +18 -19
  20. package/dist/lib/llm-connect.js +150 -0
  21. package/dist/lib/llm-preference.js +102 -0
  22. package/dist/lib/llm-status.js +19 -0
  23. package/dist/lib/paths.js +7 -3
  24. package/dist/lib/plan-llm-openai.js +0 -63
  25. package/dist/lib/pr-create.js +66 -0
  26. package/dist/lib/resolve-task.js +34 -0
  27. package/dist/lib/task-add-llm.js +53 -233
  28. package/dist/lib/task-context.js +68 -0
  29. package/dist/lib/task-done-llm.js +155 -0
  30. package/dist/lib/task-pr-llm.js +50 -0
  31. package/dist/lib/task-push-pr.js +131 -0
  32. package/dist/lib/task-scaffold.js +39 -43
  33. package/dist/lib/task-start.js +100 -0
  34. package/dist/lib/task-summary.js +12 -239
  35. package/dist/lib/task.js +30 -24
  36. package/dist/types/config.js +0 -16
  37. package/package.json +14 -14
  38. package/templates/.cursor/rules/02-git-safety.mdc +12 -0
  39. package/templates/AGENTS.md +27 -87
  40. package/templates/clients/claude/CLAUDE.md +28 -0
  41. package/templates/clients/cursor/.cursor/rules/01-task-source-of-truth.mdc +12 -0
  42. package/templates/clients/cursor/.cursor/rules/02-git-safety.mdc +11 -0
  43. package/templates/clients/cursor/.cursor/rules/03-docs-on-done.mdc +13 -0
  44. package/templates/core/AGENTS.md +44 -0
  45. package/templates/core/docs/logs/README.md +7 -0
  46. package/templates/core/docs/project/03-architecture.md +15 -0
  47. package/templates/core/docs/project/05-current-state.md +15 -0
  48. package/templates/core/docs/project/06-decisions.md +9 -0
  49. package/templates/core/docs/tasks/TASK-000-template.md +37 -0
  50. package/templates/skills-shared/implement-task/SKILL.md +22 -0
  51. package/templates/skills-shared/plan-task/SKILL.md +19 -0
  52. package/dist/agent/loader.js +0 -71
  53. package/dist/agent/prompt.js +0 -66
  54. package/dist/commands/agent-list.js +0 -32
  55. package/dist/commands/agent-prompt.js +0 -59
  56. package/dist/commands/agent-show.js +0 -26
  57. package/dist/commands/done.js +0 -160
  58. package/dist/commands/github-init.js +0 -554
  59. package/dist/commands/github-status.js +0 -164
  60. package/dist/commands/next.js +0 -283
  61. package/dist/commands/notion-init.js +0 -764
  62. package/dist/commands/notion-sync.js +0 -405
  63. package/dist/commands/notion-test.js +0 -595
  64. package/dist/commands/plan.js +0 -146
  65. package/dist/commands/rollback.js +0 -126
  66. package/dist/commands/start.js +0 -129
  67. package/dist/commands/task-check.js +0 -155
  68. package/dist/commands/task-generate.js +0 -206
  69. package/dist/commands/task-pull.js +0 -277
  70. package/dist/commands/task-rollback.js +0 -174
  71. package/dist/commands/task-start.js +0 -102
  72. package/dist/commands/task-status.js +0 -122
  73. package/dist/lib/brief.js +0 -356
  74. package/dist/lib/cursor-task-prompt.js +0 -60
  75. package/dist/lib/done-follow-up.js +0 -308
  76. package/dist/lib/github-cli.js +0 -247
  77. package/dist/lib/guide-state.js +0 -69
  78. package/dist/lib/mvp-artifacts.js +0 -204
  79. package/dist/lib/mvp-constants.js +0 -15
  80. package/dist/lib/mvp-diff-summary.js +0 -43
  81. package/dist/lib/mvp-done-summary.js +0 -335
  82. package/dist/lib/notion-client.js +0 -459
  83. package/dist/lib/notion-discovery.js +0 -671
  84. package/dist/lib/notion-env.js +0 -140
  85. package/dist/lib/notion-mappers.js +0 -148
  86. package/dist/lib/notion-schema.js +0 -272
  87. package/dist/lib/notion-sync.js +0 -337
  88. package/dist/lib/notion-target.js +0 -247
  89. package/dist/lib/package-json.js +0 -133
  90. package/dist/lib/plan-apply-planner.js +0 -131
  91. package/dist/lib/plan-codex-pkce.js +0 -234
  92. package/dist/lib/plan-llm-models.js +0 -237
  93. package/dist/lib/plan-llm-normalize.js +0 -146
  94. package/dist/lib/plan-llm-session.js +0 -682
  95. package/dist/lib/plan-post-apply-setup.js +0 -116
  96. package/dist/lib/project-docs.js +0 -95
  97. package/dist/lib/prompt-builder.js +0 -135
  98. package/dist/lib/resolve-command-task.js +0 -40
  99. package/dist/lib/task-add-build-prompt.js +0 -39
  100. package/dist/lib/task-add-cursor.js +0 -81
  101. package/dist/lib/task-generator.js +0 -183
  102. package/dist/lib/task-merge.js +0 -220
  103. package/dist/lib/task-prompt.js +0 -23
  104. package/dist/lib/task-pull.js +0 -354
  105. package/dist/lib/task-status-brief.js +0 -132
  106. package/dist/lib/workflow-guide.js +0 -485
  107. package/dist/status/collector.js +0 -103
  108. package/dist/status/format.js +0 -181
  109. package/dist/types/brief.js +0 -126
  110. package/templates/.cursor/rules/00-project-governance.mdc +0 -28
  111. package/templates/.cursor/rules/01-agent-orchestration.mdc +0 -48
  112. package/templates/.cursor/rules/02-task-workflow.mdc +0 -38
  113. package/templates/.cursor/rules/03-git-safety.mdc +0 -30
  114. package/templates/.cursor/rules/04-docs-update.mdc +0 -22
  115. package/templates/.vibeops/agents/architect.md +0 -47
  116. package/templates/.vibeops/agents/builder.md +0 -38
  117. package/templates/.vibeops/agents/docs.md +0 -54
  118. package/templates/.vibeops/agents/orchestrator.md +0 -40
  119. package/templates/.vibeops/agents/planner.md +0 -60
  120. package/templates/.vibeops/agents/recovery.md +0 -49
  121. package/templates/.vibeops/agents/reviewer.md +0 -47
  122. package/templates/.vibeops/agents/tester.md +0 -43
  123. package/templates/.vibeops/prompts/create-plan.md +0 -33
  124. package/templates/.vibeops/prompts/generate-tasks.md +0 -41
  125. package/templates/.vibeops/prompts/implement-task.md +0 -39
  126. package/templates/.vibeops/prompts/review-task.md +0 -34
  127. package/templates/.vibeops/prompts/rollback.md +0 -32
  128. package/templates/.vibeops/prompts/start-project.md +0 -39
  129. package/templates/.vibeops/workflows/notion-sync.md +0 -53
  130. package/templates/.vibeops/workflows/project-start.md +0 -73
  131. package/templates/.vibeops/workflows/rollback.md +0 -45
  132. package/templates/.vibeops/workflows/task-lifecycle.md +0 -71
  133. package/templates/docs/logs/README.md +0 -38
  134. package/templates/docs/project/00-overview.md +0 -27
  135. package/templates/docs/project/01-requirements.md +0 -30
  136. package/templates/docs/project/02-mvp-scope.md +0 -36
  137. package/templates/docs/project/03-architecture.md +0 -34
  138. package/templates/docs/project/04-tech-stack.md +0 -29
  139. package/templates/docs/project/05-current-state.md +0 -35
  140. package/templates/docs/project/06-decisions.md +0 -20
  141. package/templates/docs/project/07-backlog.md +0 -23
  142. package/templates/docs/project/08-env.md +0 -29
  143. package/templates/docs/project/09-deployment.md +0 -28
  144. package/templates/docs/tasks/TASK-000-template.md +0 -72
@@ -1,181 +0,0 @@
1
- import { relative } from "node:path";
2
- import { bold, cyan, dim, green, log, red, yellow } from "../lib/logger.js";
3
- function relOrAbs(root, p) {
4
- const r = relative(root, p);
5
- if (r === "")
6
- return ".";
7
- if (r.startsWith(".."))
8
- return p;
9
- return r;
10
- }
11
- function statusBadge(value, label) {
12
- if (value === 0)
13
- return dim(`${label}:0`);
14
- return `${label}:${value}`;
15
- }
16
- function pad(label, width) {
17
- if (label.length >= width)
18
- return label;
19
- return label + " ".repeat(width - label.length);
20
- }
21
- function tokenLine(report) {
22
- if (!report.notion.hasToken)
23
- return red("missing");
24
- return `${green("configured")} ${dim(`(${report.notion.tokenSource})`)}`;
25
- }
26
- function targetLine(present) {
27
- return present ? green("configured") : red("missing");
28
- }
29
- function notionHint(report) {
30
- if (!report.notion.enabled)
31
- return "run `vibeops notion init`";
32
- if (!report.notion.hasToken)
33
- return "set NOTION_TOKEN in `.vibeops.env`";
34
- if (!report.notion.hasProjectsTarget || !report.notion.hasTasksTarget) {
35
- return "run `vibeops notion init` to pick a Projects / Tasks DB";
36
- }
37
- return "run `vibeops notion test`";
38
- }
39
- export function printHuman(report) {
40
- log.info(bold("Project"));
41
- if (report.config) {
42
- log.info(` name ${report.config.name}`);
43
- log.info(` vibeopsVersion ${report.config.vibeopsVersion}`);
44
- log.info(` schemaVersion ${String(report.config.schemaVersion)}`);
45
- log.info(` createdAt ${report.config.createdAt}`);
46
- }
47
- else {
48
- log.info(` ${red("(no .vibeops.json — not a VibeOps project)")}`);
49
- }
50
- log.blank();
51
- log.info(bold("Installation"));
52
- for (const c of report.checks) {
53
- const tag = c.present
54
- ? green("✓")
55
- : c.required
56
- ? red("✗")
57
- : yellow("·");
58
- const reqHint = c.required ? "" : dim(" (optional)");
59
- log.info(` ${tag} ${c.label}${reqHint} ${dim(relOrAbs(report.cwd, c.path))}`);
60
- }
61
- if (report.missingRequired.length > 0) {
62
- log.blank();
63
- log.warn(`${report.missingRequired.length} required path(s) missing.`);
64
- }
65
- log.blank();
66
- log.info(bold("Tasks"));
67
- const { total, planned, in_progress, review, blocked, done } = report.taskCounts;
68
- log.info(` ${cyan(`total:${total}`)} ${statusBadge(planned, "planned")} ${statusBadge(in_progress, "in_progress")} ${statusBadge(review, "review")} ${statusBadge(blocked, "blocked")} ${statusBadge(done, "done")}`);
69
- if (report.nextTask) {
70
- log.info(` next ${report.nextTask.id} — ${report.nextTask.title || dim("(no title)")} ${dim(`[${report.nextTask.status}]`)}`);
71
- }
72
- else if (total === 0) {
73
- log.info(` ${dim("no TASK files — run `vibeops plan`")}`);
74
- }
75
- else {
76
- log.info(` ${dim("all tracked tasks done")}`);
77
- }
78
- const mvp = report.tasks.find((t) => t.id.toUpperCase() === "TASK-MVP");
79
- if (mvp && mvp.status !== "done") {
80
- log.info(` workflow ${cyan("vibeops start")} → ${cyan(".vibeops/generated/mvp-build.md")} in Cursor → ${cyan("vibeops done")}`);
81
- }
82
- log.blank();
83
- log.info(bold("Git"));
84
- if (!report.git.isRepo) {
85
- log.info(` ${dim("not a git repository")}`);
86
- }
87
- else {
88
- if (report.git.state === "unborn") {
89
- log.info(` branch ${report.git.branch ?? "(unknown)"} ${dim("(unborn, no commits yet)")}`);
90
- }
91
- else if (report.git.state === "detached") {
92
- log.info(` branch ${dim("(detached)")}${report.git.branch ? ` ${report.git.branch}` : ""}`);
93
- }
94
- else {
95
- log.info(` branch ${report.git.branch ?? dim("(unknown)")}`);
96
- }
97
- log.info(` status ${report.git.dirty ? yellow("dirty") : green("clean")}`);
98
- if (report.git.state === "unborn") {
99
- log.info(` hint create the first commit or run ${cyan("`vibeops init --git --initial-commit`")}`);
100
- }
101
- }
102
- log.blank();
103
- // Notion: enabled / token / projects target / tasks target / hint.
104
- // We intentionally do NOT print legacy env names (NOTION_API_KEY,
105
- // NOTION_PROJECT_DB, NOTION_TASK_DB) — modern VibeOps only uses
106
- // NOTION_TOKEN + notion.{projectsTargetId,tasksTargetId}.
107
- log.info(bold("Notion"));
108
- const notionLabelWidth = 16; // "projects target"
109
- log.info(` ${pad("enabled", notionLabelWidth)} ${report.notion.enabled ? green("yes") : dim("no")}`);
110
- log.info(` ${pad("token", notionLabelWidth)} ${tokenLine(report)}`);
111
- log.info(` ${pad("projects target", notionLabelWidth)} ${targetLine(report.notion.hasProjectsTarget)}`);
112
- log.info(` ${pad("tasks target", notionLabelWidth)} ${targetLine(report.notion.hasTasksTarget)}`);
113
- log.info(` ${pad("hint", notionLabelWidth)} ${dim(notionHint(report))}`);
114
- log.blank();
115
- log.info(bold("GitHub"));
116
- const githubLabelWidth = 11; // "owner/repo"
117
- if (!report.github.enabled) {
118
- log.info(` ${pad("enabled", githubLabelWidth)} ${dim("no")}`);
119
- log.info(` ${pad("hint", githubLabelWidth)} ${dim("run `vibeops github init`")}`);
120
- }
121
- else {
122
- log.info(` ${pad("enabled", githubLabelWidth)} ${green("yes")}`);
123
- if (report.github.mode.length > 0) {
124
- log.info(` ${pad("mode", githubLabelWidth)} ${report.github.mode}`);
125
- }
126
- const slug = report.github.owner.length > 0 && report.github.repo.length > 0
127
- ? `${report.github.owner}/${report.github.repo}`
128
- : dim("(unknown)");
129
- log.info(` ${pad("owner/repo", githubLabelWidth)} ${slug}`);
130
- log.info(` ${pad("remote", githubLabelWidth)} ${report.github.remote.length > 0 ? report.github.remote : dim("(none)")}`);
131
- log.info(` ${pad("url", githubLabelWidth)} ${report.github.url.length > 0 ? report.github.url : dim("(none)")}`);
132
- }
133
- log.blank();
134
- log.info(bold("Package"));
135
- const pkgLabelWidth = 8; // "version"
136
- if (!report.package.exists) {
137
- log.info(` ${dim("package.json missing")}`);
138
- }
139
- else {
140
- log.info(` ${pad("name", pkgLabelWidth)} ${report.package.name.length > 0 ? report.package.name : dim("(unset)")}`);
141
- log.info(` ${pad("version", pkgLabelWidth)} ${report.package.version.length > 0 ? report.package.version : dim("(unset)")}`);
142
- log.info(` ${pad("bin", pkgLabelWidth)} ${report.package.bin.length > 0 ? report.package.bin : dim("(none)")}`);
143
- }
144
- log.blank();
145
- if (!report.isVibeopsProject) {
146
- log.error("Not a VibeOps project — run `vibeops init` first.");
147
- }
148
- else {
149
- log.ok("VibeOps project ready.");
150
- }
151
- }
152
- export function toJson(report) {
153
- return `${JSON.stringify({
154
- cwd: report.cwd,
155
- isVibeopsProject: report.isVibeopsProject,
156
- config: report.config,
157
- installation: {
158
- checks: report.checks.map((c) => ({
159
- label: c.label,
160
- path: c.path,
161
- present: c.present,
162
- required: c.required,
163
- })),
164
- missingRequired: report.missingRequired.map((c) => c.label),
165
- },
166
- tasks: {
167
- counts: report.taskCounts,
168
- next: report.nextTask
169
- ? {
170
- id: report.nextTask.id,
171
- title: report.nextTask.title,
172
- status: report.nextTask.status,
173
- }
174
- : null,
175
- },
176
- git: report.git,
177
- notion: report.notion,
178
- github: report.github,
179
- package: report.package,
180
- }, null, 2)}\n`;
181
- }
@@ -1,126 +0,0 @@
1
- export const PROJECT_BRIEF_SCHEMA_VERSION = 1;
2
- export const PROJECT_TYPE_CHOICES = [
3
- "SaaS",
4
- "Web App",
5
- "CLI Tool",
6
- "Browser Automation",
7
- "AI Agent",
8
- "Internal Tool",
9
- "Other",
10
- ];
11
- export const TARGET_USER_CHOICES = [
12
- "Solo founders",
13
- "Developers",
14
- "Marketers",
15
- "Small business owners",
16
- "Internal team",
17
- "Other",
18
- ];
19
- export const MVP_FEATURE_CHOICES = [
20
- "Authentication",
21
- "Dashboard",
22
- "Project/workspace management",
23
- "Task/job creation",
24
- "Background worker",
25
- "Browser automation",
26
- "Scheduling",
27
- "Execution logs",
28
- "External integrations",
29
- "Other",
30
- ];
31
- export const OUT_OF_SCOPE_CHOICES = [
32
- "Billing",
33
- "Team workspace",
34
- "Mobile app",
35
- "Marketplace",
36
- "Advanced analytics",
37
- "Enterprise SSO",
38
- "Public API",
39
- "Real-time collaboration",
40
- "Other",
41
- ];
42
- export const FRONTEND_CHOICES = [
43
- "Next.js",
44
- "React + Vite",
45
- "None / CLI only",
46
- "Not sure",
47
- "Other",
48
- ];
49
- export const BACKEND_CHOICES = [
50
- "NestJS",
51
- "Next.js API routes",
52
- "Node.js Fastify",
53
- "Hono",
54
- "Python FastAPI",
55
- "None",
56
- "Not sure",
57
- "Other",
58
- ];
59
- export const DATABASE_CHOICES = [
60
- "PostgreSQL",
61
- "SQLite",
62
- "MySQL",
63
- "Supabase",
64
- "None",
65
- "Not sure",
66
- "Other",
67
- ];
68
- export const DB_LAYER_CHOICES = [
69
- "Drizzle",
70
- "Prisma",
71
- "Kysely",
72
- "Raw SQL",
73
- "None",
74
- "Not sure",
75
- "Other",
76
- ];
77
- export const PACKAGE_MANAGER_CHOICES = ["pnpm", "npm", "yarn", "bun"];
78
- export const DEPLOYMENT_TARGET_CHOICES = [
79
- "VPS",
80
- "Docker",
81
- "Podman",
82
- "Vercel",
83
- "Cloudflare",
84
- "AWS",
85
- "Not sure",
86
- "Other",
87
- ];
88
- export const AUTH_REQUIREMENT_CHOICES = [
89
- "Email/password",
90
- "Google login",
91
- "GitHub login",
92
- "Magic link",
93
- "Admin-only",
94
- "No auth for MVP",
95
- "Not sure",
96
- "Other",
97
- ];
98
- export const INTEGRATION_CHOICES = [
99
- "Notion",
100
- "GitHub",
101
- "Google Drive",
102
- "Gmail",
103
- "Slack",
104
- "Stripe",
105
- "OpenAI",
106
- "Anthropic",
107
- "Browser / Playwright",
108
- "None",
109
- "Other",
110
- ];
111
- export const AGENT_WORKFLOW_CHOICES = [
112
- "Simple: Planner + Builder + Reviewer",
113
- "Standard: Orchestrator + Planner + Builder + Reviewer + Docs",
114
- "Advanced: Orchestrator + Planner + Architect + Builder + Tester + Reviewer + Docs + Recovery",
115
- ];
116
- export const RISK_AREA_CHOICES = [
117
- "Authentication/security",
118
- "Browser automation reliability",
119
- "Cost control",
120
- "Scalability",
121
- "Data privacy",
122
- "Deployment complexity",
123
- "Background jobs",
124
- "AI hallucination",
125
- "Other",
126
- ];
@@ -1,28 +0,0 @@
1
- ---
2
- description: Governance for {{PROJECT_NAME}} — source of truth, single TASK, MVP boundary.
3
- alwaysApply: true
4
- ---
5
-
6
- # Project Governance
7
-
8
- ## Source of truth
9
-
10
- - **`docs/project/`** and **`docs/tasks/`** take precedence. Chat history is not trusted.
11
- - When docs and chat disagree, align the docs **first**, then implement.
12
- - The human dashboard (Notion) syncs **summary, status, priority, branch, docs path, and result summary only**. Full bodies live in `docs/tasks/*.md`.
13
-
14
- ## One TASK at a time
15
-
16
- - Implementation must correspond to **a single TASK**.
17
- - Stay inside the TASK's **Scope / Acceptance Criteria**.
18
- - Use the TASK ID (`TASK-NNN`) consistently across commit messages, branch names, and log entries.
19
-
20
- ## Protect the MVP scope
21
-
22
- - Do **not** add features that are not listed in `docs/project/02-mvp-scope.md`.
23
- - "Convenience" items such as hosting, realtime sync, webhooks, and automatic LLM calls are introduced only via a dedicated TASK.
24
-
25
- ## Refactors and integrations
26
-
27
- - Large refactors happen only when a dedicated TASK calls for them.
28
- - External integrations (Git host APIs, Notion, messengers, …) are added only when the TASK explicitly says so.
@@ -1,48 +0,0 @@
1
- ---
2
- description: How 8 agents in .vibeops/agents/* collaborate on a single TASK.
3
- alwaysApply: true
4
- ---
5
-
6
- # Agent Orchestration
7
-
8
- This project defines 8 agents in `.vibeops/agents/*.md`. Every agent stays inside **its own role**.
9
-
10
- ## Flow
11
-
12
- ```
13
- user / PM
14
- │
15
- ▼
16
- [orchestrator] ── picks the next TASK, calls the right agent
17
- │
18
- ├──▶ [planner] idea → docs/project/{00,01,02,07}
19
- ├──▶ [architect] docs/project/{03,04}
20
- ├──▶ [builder] one TASK, code changes
21
- ├──▶ [reviewer] diff vs Acceptance Criteria
22
- ├──▶ [tester] run Test Plan → Test Result
23
- ├──▶ [docs] update 05-current-state / TASK Result / logs
24
- └──▶ [recovery] diagnose rollback (destructive actions require --confirm)
25
- ```
26
-
27
- ## How to invoke
28
-
29
- Get an agent prompt from the VibeOps CLI:
30
-
31
- ```
32
- vibeops agent prompt <agent> <TASK-NNN>
33
- vibeops task prompt <TASK-NNN> --agent <agent>
34
- ```
35
-
36
- Paste the resulting markdown directly into the Cursor chat.
37
-
38
- ## Role boundaries
39
-
40
- - `builder` does not do `reviewer`'s job (self-checks are fine, but a real review is a separate call).
41
- - `planner` does not write code. `architect` does not decide business logic.
42
- - `docs` does not make code changes — documentation only.
43
- - No agent runs **multiple TASKs in parallel**.
44
-
45
- ## Forbidden
46
-
47
- - "Not really my job but I'll just do it" — no. Call the right agent again.
48
- - Editing the agent definition files (`.vibeops/agents/*.md`) without a TASK that authorizes it.
@@ -1,38 +0,0 @@
1
- ---
2
- description: Task workflow — start, prompt, check, done lifecycle and dry-run discipline.
3
- alwaysApply: true
4
- ---
5
-
6
- # Task Workflow
7
-
8
- ## Before you start
9
-
10
- 1. Read `docs/project/05-current-state.md` and identify the next TASK to run.
11
- 2. Read the **entire** `docs/tasks/TASK-NNN-*.md` file.
12
- 3. Keep Scope / Out of Scope / Acceptance Criteria in mind.
13
- 4. **Search** the existing code for similar implementations and patterns (do not duplicate).
14
-
15
- ## While implementing
16
-
17
- - Run **one TASK at a time**.
18
- - Search the existing code once more before adding new files, functions, or patterns.
19
- - **Every CLI command should support `--dry-run`** (or an equivalent) so the plan can be previewed without touching files, Git, or remotes.
20
- - Do not edit the next TASK file before the current TASK is done.
21
-
22
- ## Lifecycle commands
23
-
24
- | Step | Command |
25
- | ---------- | -------------------------------------------------------------------- |
26
- | Start | `vibeops task start TASK-NNN` |
27
- | Work | `vibeops task prompt TASK-NNN --agent builder` → paste into Cursor |
28
- | Check | `vibeops task check TASK-NNN` |
29
- | Finish | `vibeops task done TASK-NNN` (no auto-merge) |
30
- | Roll back | `vibeops task rollback TASK-NNN` (guidance by default, destructive paths need `--confirm`) |
31
-
32
- ## Definition of done
33
-
34
- - All Acceptance Criteria pass.
35
- - The TASK file's **Result** and **Test Result** are non-empty.
36
- - `docs/project/05-current-state.md` and `docs/logs/YYYY-MM-DD.md` are updated.
37
-
38
- A TASK is not considered complete until all three updates land.
@@ -1,30 +0,0 @@
1
- ---
2
- description: Git safety — branch per TASK, rollback safety, never force-push.
3
- alwaysApply: true
4
- ---
5
-
6
- # Git Safety
7
-
8
- ## Branch policy
9
-
10
- - One branch per TASK: `task/<task-id>-<slug>`, e.g. `task/002-init-command`.
11
- - At TASK start, the base branch / base commit / task branch are recorded in `.vibeops/state/tasks/TASK-NNN.json` (automatic).
12
- - After merge, the task branch is deleted by default (`git branch -d`). Discarding an unmerged branch goes through the rollback flow.
13
-
14
- ## Commit messages
15
-
16
- - Include the TASK ID. Examples: `feat(TASK-002): vibeops init`, `docs(TASK-006): plan command spec`.
17
- - One commit covers only one TASK's scope.
18
-
19
- ## Safety rules
20
-
21
- - `vibeops task rollback` produces **guidance by default**. Destructive Git actions run only with `--confirm`.
22
- - **No force-push** (especially on shared branches).
23
- - No automatic merge, no automatic push. A human does both explicitly.
24
- - `task start` refuses a dirty working tree unless every changed path is under governance docs (`docs/tasks/`, `docs/project/`, `docs/logs/`, `.vibeops/state/`); then it proceeds with a warning. `--allow-dirty` overrides for any dirty path.
25
-
26
- ## Forbidden
27
-
28
- - Doing several TASKs on one branch.
29
- - Omitting the TASK ID from a commit message.
30
- - Committing directly to shared branches such as `main` / `master` — always go through the TASK branch.
@@ -1,22 +0,0 @@
1
- ---
2
- description: After implementation, update three documents together.
3
- alwaysApply: true
4
- ---
5
-
6
- # Docs Update
7
-
8
- Update the three documents below **together** when the implementation is done. A TASK is not considered complete until all three are updated.
9
-
10
- 1. **`docs/project/05-current-state.md`** — facts only (implementation stage, paths, next TASK).
11
- 2. **`docs/tasks/TASK-NNN-*.md`** — Status, **Result**, **Test Result**.
12
- 3. **`docs/logs/YYYY-MM-DD.md`** — local-date filename; create the file if it does not exist. If multiple updates happen on the same day, add entries to the same file.
13
-
14
- ## Tone
15
-
16
- - **Facts first**. No marketing copy, no self-praise.
17
- - Record the changed file paths, the commands you ran with their results, and the decisions you made.
18
- - A teammate (or your future self in five minutes) should grasp "where things stand" within a minute.
19
-
20
- ## Chat report
21
-
22
- Follow the "Completion report" section in `AGENTS.md`.
@@ -1,47 +0,0 @@
1
- ---
2
- name: architect
3
- role: Fill docs/project/03-architecture.md and 04-tech-stack.md.
4
- description: Decides system structure and tech stack.
5
- ---
6
-
7
- # Architect Agent
8
-
9
- ## Role
10
-
11
- The architect takes the planner's "what we will build" and decides the high-level "how". Fill only two documents:
12
-
13
- - `docs/project/03-architecture.md` — components, data flow, external boundaries.
14
- - `docs/project/04-tech-stack.md` — language, runtime, key libraries, infrastructure.
15
-
16
- ## Inputs
17
-
18
- - `docs/project/00-overview.md`, `01-requirements.md`, `02-mvp-scope.md`.
19
- - User-imposed tech constraints (e.g. "Node only", "DB must be SQLite").
20
-
21
- ## Output Format
22
-
23
- Two fenced blocks.
24
-
25
- ```
26
- <!-- file: docs/project/03-architecture.md -->
27
- # Architecture
28
- ...
29
- ```
30
-
31
- ```
32
- <!-- file: docs/project/04-tech-stack.md -->
33
- # Tech Stack
34
- ...
35
- ```
36
-
37
- ## Rules
38
-
39
- - During MVP, **prefer the simple choice**. Message queues, caches, microservices are not introduced without a dedicated TASK.
40
- - In `03`, draw the "in scope / out of scope" boundary visually (ASCII diagram is fine).
41
- - In `04`, write a one-line "why" next to each choice.
42
-
43
- ## Forbidden
44
-
45
- - Writing code or installing dependencies (that is the builder's job).
46
- - Changing requirements (route back to the planner if needed).
47
- - Reordering the backlog.
@@ -1,38 +0,0 @@
1
- ---
2
- name: builder
3
- role: Implement a single TASK end-to-end (code only, single task).
4
- description: Writes code inside the Scope of one TASK.
5
- ---
6
-
7
- # Builder Agent
8
-
9
- ## Role
10
-
11
- The builder takes a single `docs/tasks/TASK-NNN-*.md` and changes code inside that TASK's Scope.
12
-
13
- ## Inputs
14
-
15
- - The **entire** TASK file.
16
- - `AGENTS.md`, `.cursor/rules/*`, `docs/project/03-architecture.md`, `04-tech-stack.md`, `06-decisions.md`.
17
- - Relevant existing source code (verify directly via search).
18
-
19
- ## Output Format
20
-
21
- 1. List of files to change (path + new/update).
22
- 2. The change for each file (as code blocks).
23
- 3. Commands to run for verification (`pnpm typecheck`, `pnpm build`, …).
24
- 4. Draft TASK Result / Test Result (self-evaluation; reviewer / tester make the final call).
25
-
26
- ## Rules
27
-
28
- - Stay **inside the TASK Scope**. If other files seem to need work, note it for a separate TASK rather than fixing it here.
29
- - Before adding a new file, **search** for similar modules. No duplicates.
30
- - Design every mutating command with `--dry-run` (or an equivalent) when possible.
31
- - Paths that could destroy user data (file deletion, DB drop, …) live behind a `--confirm` gate.
32
-
33
- ## Forbidden
34
-
35
- - Running multiple TASKs in parallel.
36
- - Adding "bonus features" after Acceptance Criteria pass.
37
- - Automatic merge / automatic push.
38
- - Reporting "done" with empty Result / Test Result on the TASK file.
@@ -1,54 +0,0 @@
1
- ---
2
- name: docs
3
- role: Update 05-current-state, TASK Result/Test Result, docs/logs/YYYY-MM-DD.md.
4
- description: After implementation, updates three documents together.
5
- ---
6
-
7
- # Docs Agent
8
-
9
- ## Role
10
-
11
- The docs agent takes a TASK finished by builder / reviewer / tester and updates three documents. It does not touch code.
12
-
13
- 1. `docs/project/05-current-state.md`
14
- 2. `docs/tasks/TASK-NNN-*.md` (Status, Result, Test Result)
15
- 3. `docs/logs/YYYY-MM-DD.md`
16
-
17
- ## Inputs
18
-
19
- - The TASK file.
20
- - The builder's list of changed files.
21
- - The tester's Test Result.
22
- - The reviewer's Verdict.
23
-
24
- ## Output Format
25
-
26
- Three fenced blocks.
27
-
28
- ```
29
- <!-- file: docs/project/05-current-state.md -->
30
- ...
31
- ```
32
-
33
- ```
34
- <!-- file: docs/tasks/TASK-NNN-*.md -->
35
- ... (only update the Status / Result / Test Result sections)
36
- ```
37
-
38
- ```
39
- <!-- file: docs/logs/YYYY-MM-DD.md -->
40
- ... (append an entry to that day's file; create the file if missing)
41
- ```
42
-
43
- ## Rules
44
-
45
- - **Facts only**. No self-praise, no exaggeration.
46
- - Keep `05-current-state.md` structured as "Stage / What is in place / What is still missing / Next TASK".
47
- - Log entries include "Decision summary / Changed files / Verification result / Next work".
48
- - Do not touch body sections (Scope, etc.) on the TASK file. Only fill in **Result / Test Result**.
49
-
50
- ## Forbidden
51
-
52
- - Updating files outside this TASK (anything beyond 05 / TASK / log).
53
- - Writing "Test Result: pass" based on chat summary alone — the tester's Verdict is the source.
54
- - Filling sections with "TBD" or "TODO" only.
@@ -1,40 +0,0 @@
1
- ---
2
- name: orchestrator
3
- role: Top-level coordinator. Picks next TASK and dispatches to specialized agents.
4
- description: Decides what to do next and delegates to the right agent. Never writes code directly.
5
- ---
6
-
7
- # Orchestrator Agent
8
-
9
- ## Role
10
-
11
- The orchestrator answers "what should we do next?" for the project. It never writes code directly. It reads `docs/project/05-current-state.md` and `docs/project/07-backlog.md`, picks the next TASK, and names the agent that should run it.
12
-
13
- ## Inputs
14
-
15
- - `docs/project/05-current-state.md`
16
- - `docs/project/07-backlog.md`
17
- - Short decisions from the user (priority changes, etc.)
18
-
19
- ## Output Format
20
-
21
- ```
22
- Next: TASK-NNN — <title>
23
- Why: <one sentence on why this TASK is next>
24
- Agent: <planner | architect | builder | reviewer | tester | docs | recovery>
25
- Command: vibeops task prompt TASK-NNN --agent <agent>
26
- ```
27
-
28
- Three lines plus one command line. Say nothing more.
29
-
30
- ## Rules
31
-
32
- - Pick exactly one TASK per response.
33
- - When unsure, choose the TASK with the smallest "Out of Scope" surface and the fewest open dependencies.
34
- - If the Acceptance Criteria are ambiguous, route the work to `planner` / `architect` / `docs` first instead of `builder`.
35
-
36
- ## Forbidden
37
-
38
- - Writing code or editing files directly.
39
- - Bundling multiple TASKs into one response.
40
- - Inventing a new TASK on the spot when it is not in the backlog (use the `vibeops task generate` flow for that).