aidevops 2.52.1 → 2.53.2

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 (334) hide show
  1. package/README.md +1 -1
  2. package/VERSION +1 -1
  3. package/aidevops.sh +15 -9
  4. package/package.json +4 -4
  5. package/scripts/npm-postinstall.js +6 -7
  6. package/setup.sh +1 -1
  7. package/templates/deploy-templates.sh +144 -0
  8. package/templates/home/.agent/README.md +33 -0
  9. package/templates/home/AGENTS.md +96 -0
  10. package/templates/home/git/.agent/README.md +48 -0
  11. package/templates/home/git/AGENTS.md +97 -0
  12. package/templates/standard-functions.sh +179 -0
  13. package/templates/wordpress-performance-workflow.md +217 -0
  14. package/.agent/AGENTS.md +0 -614
  15. package/.agent/accounts.md +0 -65
  16. package/.agent/aidevops/add-new-mcp-to-aidevops.md +0 -456
  17. package/.agent/aidevops/api-integrations.md +0 -335
  18. package/.agent/aidevops/architecture.md +0 -510
  19. package/.agent/aidevops/configs.md +0 -274
  20. package/.agent/aidevops/docs.md +0 -244
  21. package/.agent/aidevops/extension.md +0 -311
  22. package/.agent/aidevops/mcp-integrations.md +0 -340
  23. package/.agent/aidevops/mcp-troubleshooting.md +0 -162
  24. package/.agent/aidevops/memory-patterns.md +0 -172
  25. package/.agent/aidevops/providers.md +0 -217
  26. package/.agent/aidevops/recommendations.md +0 -321
  27. package/.agent/aidevops/requirements.md +0 -301
  28. package/.agent/aidevops/resources.md +0 -214
  29. package/.agent/aidevops/security-requirements.md +0 -174
  30. package/.agent/aidevops/security.md +0 -350
  31. package/.agent/aidevops/service-links.md +0 -400
  32. package/.agent/aidevops/services.md +0 -357
  33. package/.agent/aidevops/setup.md +0 -153
  34. package/.agent/aidevops/troubleshooting.md +0 -389
  35. package/.agent/aidevops.md +0 -124
  36. package/.agent/build-plus.md +0 -244
  37. package/.agent/content/guidelines.md +0 -109
  38. package/.agent/content.md +0 -87
  39. package/.agent/health.md +0 -59
  40. package/.agent/legal.md +0 -59
  41. package/.agent/loop-state/full-loop.local.md +0 -16
  42. package/.agent/loop-state/ralph-loop.local.md +0 -10
  43. package/.agent/marketing.md +0 -440
  44. package/.agent/memory/README.md +0 -260
  45. package/.agent/onboarding.md +0 -796
  46. package/.agent/plan-plus.md +0 -245
  47. package/.agent/research.md +0 -100
  48. package/.agent/sales.md +0 -333
  49. package/.agent/scripts/101domains-helper.sh +0 -701
  50. package/.agent/scripts/add-missing-returns.sh +0 -140
  51. package/.agent/scripts/agent-browser-helper.sh +0 -311
  52. package/.agent/scripts/agno-setup.sh +0 -712
  53. package/.agent/scripts/ahrefs-mcp-wrapper.js +0 -168
  54. package/.agent/scripts/aidevops-update-check.sh +0 -71
  55. package/.agent/scripts/ampcode-cli.sh +0 -522
  56. package/.agent/scripts/auto-version-bump.sh +0 -156
  57. package/.agent/scripts/autogen-helper.sh +0 -512
  58. package/.agent/scripts/beads-sync-helper.sh +0 -596
  59. package/.agent/scripts/closte-helper.sh +0 -5
  60. package/.agent/scripts/cloudron-helper.sh +0 -321
  61. package/.agent/scripts/codacy-cli-chunked.sh +0 -581
  62. package/.agent/scripts/codacy-cli.sh +0 -442
  63. package/.agent/scripts/code-audit-helper.sh +0 -5
  64. package/.agent/scripts/coderabbit-cli.sh +0 -417
  65. package/.agent/scripts/coderabbit-pro-analysis.sh +0 -238
  66. package/.agent/scripts/commands/code-simplifier.md +0 -86
  67. package/.agent/scripts/commands/full-loop.md +0 -246
  68. package/.agent/scripts/commands/postflight-loop.md +0 -103
  69. package/.agent/scripts/commands/recall.md +0 -182
  70. package/.agent/scripts/commands/remember.md +0 -132
  71. package/.agent/scripts/commands/save-todo.md +0 -175
  72. package/.agent/scripts/commands/session-review.md +0 -154
  73. package/.agent/scripts/comprehensive-quality-fix.sh +0 -106
  74. package/.agent/scripts/context-builder-helper.sh +0 -522
  75. package/.agent/scripts/coolify-cli-helper.sh +0 -674
  76. package/.agent/scripts/coolify-helper.sh +0 -380
  77. package/.agent/scripts/crawl4ai-examples.sh +0 -401
  78. package/.agent/scripts/crawl4ai-helper.sh +0 -1078
  79. package/.agent/scripts/crewai-helper.sh +0 -681
  80. package/.agent/scripts/dev-browser-helper.sh +0 -513
  81. package/.agent/scripts/dns-helper.sh +0 -396
  82. package/.agent/scripts/domain-research-helper.sh +0 -917
  83. package/.agent/scripts/dspy-helper.sh +0 -285
  84. package/.agent/scripts/dspyground-helper.sh +0 -291
  85. package/.agent/scripts/eeat-score-helper.sh +0 -1242
  86. package/.agent/scripts/efficient-return-fix.sh +0 -92
  87. package/.agent/scripts/extract-opencode-prompts.sh +0 -128
  88. package/.agent/scripts/find-missing-returns.sh +0 -113
  89. package/.agent/scripts/fix-auth-headers.sh +0 -104
  90. package/.agent/scripts/fix-common-strings.sh +0 -254
  91. package/.agent/scripts/fix-content-type.sh +0 -100
  92. package/.agent/scripts/fix-error-messages.sh +0 -130
  93. package/.agent/scripts/fix-misplaced-returns.sh +0 -74
  94. package/.agent/scripts/fix-remaining-literals.sh +0 -152
  95. package/.agent/scripts/fix-return-statements.sh +0 -41
  96. package/.agent/scripts/fix-s131-default-cases.sh +0 -249
  97. package/.agent/scripts/fix-sc2155-simple.sh +0 -102
  98. package/.agent/scripts/fix-shellcheck-critical.sh +0 -187
  99. package/.agent/scripts/fix-string-literals.sh +0 -273
  100. package/.agent/scripts/full-loop-helper.sh +0 -773
  101. package/.agent/scripts/generate-opencode-agents.sh +0 -497
  102. package/.agent/scripts/generate-opencode-commands.sh +0 -1629
  103. package/.agent/scripts/generate-skills.sh +0 -366
  104. package/.agent/scripts/git-platforms-helper.sh +0 -640
  105. package/.agent/scripts/gitea-cli-helper.sh +0 -743
  106. package/.agent/scripts/github-cli-helper.sh +0 -702
  107. package/.agent/scripts/gitlab-cli-helper.sh +0 -682
  108. package/.agent/scripts/gsc-add-user-helper.sh +0 -325
  109. package/.agent/scripts/gsc-sitemap-helper.sh +0 -678
  110. package/.agent/scripts/hetzner-helper.sh +0 -485
  111. package/.agent/scripts/hostinger-helper.sh +0 -229
  112. package/.agent/scripts/keyword-research-helper.sh +0 -1815
  113. package/.agent/scripts/langflow-helper.sh +0 -544
  114. package/.agent/scripts/linkedin-automation.py +0 -241
  115. package/.agent/scripts/linter-manager.sh +0 -599
  116. package/.agent/scripts/linters-local.sh +0 -434
  117. package/.agent/scripts/list-keys-helper.sh +0 -488
  118. package/.agent/scripts/local-browser-automation.py +0 -339
  119. package/.agent/scripts/localhost-helper.sh +0 -744
  120. package/.agent/scripts/loop-common.sh +0 -806
  121. package/.agent/scripts/mainwp-helper.sh +0 -728
  122. package/.agent/scripts/markdown-formatter.sh +0 -338
  123. package/.agent/scripts/markdown-lint-fix.sh +0 -311
  124. package/.agent/scripts/mass-fix-returns.sh +0 -58
  125. package/.agent/scripts/mcp-diagnose.sh +0 -167
  126. package/.agent/scripts/mcp-inspector-helper.sh +0 -449
  127. package/.agent/scripts/memory-helper.sh +0 -650
  128. package/.agent/scripts/monitor-code-review.sh +0 -255
  129. package/.agent/scripts/onboarding-helper.sh +0 -706
  130. package/.agent/scripts/opencode-github-setup-helper.sh +0 -797
  131. package/.agent/scripts/opencode-test-helper.sh +0 -213
  132. package/.agent/scripts/pagespeed-helper.sh +0 -464
  133. package/.agent/scripts/pandoc-helper.sh +0 -362
  134. package/.agent/scripts/postflight-check.sh +0 -555
  135. package/.agent/scripts/pre-commit-hook.sh +0 -259
  136. package/.agent/scripts/pre-edit-check.sh +0 -169
  137. package/.agent/scripts/qlty-cli.sh +0 -356
  138. package/.agent/scripts/quality-cli-manager.sh +0 -525
  139. package/.agent/scripts/quality-feedback-helper.sh +0 -462
  140. package/.agent/scripts/quality-fix.sh +0 -263
  141. package/.agent/scripts/quality-loop-helper.sh +0 -1108
  142. package/.agent/scripts/ralph-loop-helper.sh +0 -836
  143. package/.agent/scripts/ralph-upstream-check.sh +0 -341
  144. package/.agent/scripts/secretlint-helper.sh +0 -847
  145. package/.agent/scripts/servers-helper.sh +0 -241
  146. package/.agent/scripts/ses-helper.sh +0 -619
  147. package/.agent/scripts/session-review-helper.sh +0 -404
  148. package/.agent/scripts/setup-linters-wizard.sh +0 -379
  149. package/.agent/scripts/setup-local-api-keys.sh +0 -330
  150. package/.agent/scripts/setup-mcp-integrations.sh +0 -472
  151. package/.agent/scripts/shared-constants.sh +0 -246
  152. package/.agent/scripts/site-crawler-helper.sh +0 -1487
  153. package/.agent/scripts/snyk-helper.sh +0 -940
  154. package/.agent/scripts/sonarcloud-autofix.sh +0 -193
  155. package/.agent/scripts/sonarcloud-cli.sh +0 -191
  156. package/.agent/scripts/sonarscanner-cli.sh +0 -455
  157. package/.agent/scripts/spaceship-helper.sh +0 -747
  158. package/.agent/scripts/stagehand-helper.sh +0 -321
  159. package/.agent/scripts/stagehand-python-helper.sh +0 -321
  160. package/.agent/scripts/stagehand-python-setup.sh +0 -441
  161. package/.agent/scripts/stagehand-setup.sh +0 -439
  162. package/.agent/scripts/system-cleanup.sh +0 -340
  163. package/.agent/scripts/terminal-title-helper.sh +0 -388
  164. package/.agent/scripts/terminal-title-setup.sh +0 -549
  165. package/.agent/scripts/test-stagehand-both-integration.sh +0 -317
  166. package/.agent/scripts/test-stagehand-integration.sh +0 -309
  167. package/.agent/scripts/test-stagehand-python-integration.sh +0 -341
  168. package/.agent/scripts/todo-ready.sh +0 -263
  169. package/.agent/scripts/tool-version-check.sh +0 -362
  170. package/.agent/scripts/toon-helper.sh +0 -469
  171. package/.agent/scripts/twilio-helper.sh +0 -917
  172. package/.agent/scripts/updown-helper.sh +0 -279
  173. package/.agent/scripts/validate-mcp-integrations.sh +0 -250
  174. package/.agent/scripts/validate-version-consistency.sh +0 -131
  175. package/.agent/scripts/vaultwarden-helper.sh +0 -597
  176. package/.agent/scripts/vercel-cli-helper.sh +0 -816
  177. package/.agent/scripts/verify-mirrors.sh +0 -169
  178. package/.agent/scripts/version-manager.sh +0 -831
  179. package/.agent/scripts/webhosting-helper.sh +0 -471
  180. package/.agent/scripts/webhosting-verify.sh +0 -238
  181. package/.agent/scripts/wordpress-mcp-helper.sh +0 -508
  182. package/.agent/scripts/worktree-helper.sh +0 -595
  183. package/.agent/scripts/worktree-sessions.sh +0 -577
  184. package/.agent/seo/dataforseo.md +0 -215
  185. package/.agent/seo/domain-research.md +0 -532
  186. package/.agent/seo/eeat-score.md +0 -659
  187. package/.agent/seo/google-search-console.md +0 -366
  188. package/.agent/seo/gsc-sitemaps.md +0 -282
  189. package/.agent/seo/keyword-research.md +0 -521
  190. package/.agent/seo/serper.md +0 -278
  191. package/.agent/seo/site-crawler.md +0 -387
  192. package/.agent/seo.md +0 -236
  193. package/.agent/services/accounting/quickfile.md +0 -159
  194. package/.agent/services/communications/telfon.md +0 -470
  195. package/.agent/services/communications/twilio.md +0 -569
  196. package/.agent/services/crm/fluentcrm.md +0 -449
  197. package/.agent/services/email/ses.md +0 -399
  198. package/.agent/services/hosting/101domains.md +0 -378
  199. package/.agent/services/hosting/closte.md +0 -177
  200. package/.agent/services/hosting/cloudflare.md +0 -251
  201. package/.agent/services/hosting/cloudron.md +0 -478
  202. package/.agent/services/hosting/dns-providers.md +0 -335
  203. package/.agent/services/hosting/domain-purchasing.md +0 -344
  204. package/.agent/services/hosting/hetzner.md +0 -327
  205. package/.agent/services/hosting/hostinger.md +0 -287
  206. package/.agent/services/hosting/localhost.md +0 -419
  207. package/.agent/services/hosting/spaceship.md +0 -353
  208. package/.agent/services/hosting/webhosting.md +0 -330
  209. package/.agent/social-media.md +0 -69
  210. package/.agent/templates/plans-template.md +0 -114
  211. package/.agent/templates/prd-template.md +0 -129
  212. package/.agent/templates/tasks-template.md +0 -108
  213. package/.agent/templates/todo-template.md +0 -89
  214. package/.agent/tools/ai-assistants/agno.md +0 -471
  215. package/.agent/tools/ai-assistants/capsolver.md +0 -326
  216. package/.agent/tools/ai-assistants/configuration.md +0 -221
  217. package/.agent/tools/ai-assistants/overview.md +0 -209
  218. package/.agent/tools/ai-assistants/status.md +0 -171
  219. package/.agent/tools/ai-assistants/windsurf.md +0 -193
  220. package/.agent/tools/ai-orchestration/autogen.md +0 -406
  221. package/.agent/tools/ai-orchestration/crewai.md +0 -445
  222. package/.agent/tools/ai-orchestration/langflow.md +0 -405
  223. package/.agent/tools/ai-orchestration/openprose.md +0 -487
  224. package/.agent/tools/ai-orchestration/overview.md +0 -362
  225. package/.agent/tools/ai-orchestration/packaging.md +0 -647
  226. package/.agent/tools/browser/agent-browser.md +0 -464
  227. package/.agent/tools/browser/browser-automation.md +0 -400
  228. package/.agent/tools/browser/chrome-devtools.md +0 -282
  229. package/.agent/tools/browser/crawl4ai-integration.md +0 -422
  230. package/.agent/tools/browser/crawl4ai-resources.md +0 -277
  231. package/.agent/tools/browser/crawl4ai-usage.md +0 -416
  232. package/.agent/tools/browser/crawl4ai.md +0 -585
  233. package/.agent/tools/browser/dev-browser.md +0 -341
  234. package/.agent/tools/browser/pagespeed.md +0 -260
  235. package/.agent/tools/browser/playwright.md +0 -266
  236. package/.agent/tools/browser/playwriter.md +0 -310
  237. package/.agent/tools/browser/stagehand-examples.md +0 -456
  238. package/.agent/tools/browser/stagehand-python.md +0 -483
  239. package/.agent/tools/browser/stagehand.md +0 -421
  240. package/.agent/tools/build-agent/agent-review.md +0 -224
  241. package/.agent/tools/build-agent/build-agent.md +0 -784
  242. package/.agent/tools/build-mcp/aidevops-plugin.md +0 -476
  243. package/.agent/tools/build-mcp/api-wrapper.md +0 -445
  244. package/.agent/tools/build-mcp/build-mcp.md +0 -240
  245. package/.agent/tools/build-mcp/deployment.md +0 -401
  246. package/.agent/tools/build-mcp/server-patterns.md +0 -632
  247. package/.agent/tools/build-mcp/transports.md +0 -366
  248. package/.agent/tools/code-review/auditing.md +0 -383
  249. package/.agent/tools/code-review/automation.md +0 -219
  250. package/.agent/tools/code-review/best-practices.md +0 -203
  251. package/.agent/tools/code-review/codacy.md +0 -151
  252. package/.agent/tools/code-review/code-simplifier.md +0 -174
  253. package/.agent/tools/code-review/code-standards.md +0 -309
  254. package/.agent/tools/code-review/coderabbit.md +0 -101
  255. package/.agent/tools/code-review/management.md +0 -155
  256. package/.agent/tools/code-review/qlty.md +0 -248
  257. package/.agent/tools/code-review/secretlint.md +0 -565
  258. package/.agent/tools/code-review/setup.md +0 -250
  259. package/.agent/tools/code-review/snyk.md +0 -563
  260. package/.agent/tools/code-review/tools.md +0 -230
  261. package/.agent/tools/content/summarize.md +0 -353
  262. package/.agent/tools/context/augment-context-engine.md +0 -468
  263. package/.agent/tools/context/context-builder-agent.md +0 -76
  264. package/.agent/tools/context/context-builder.md +0 -375
  265. package/.agent/tools/context/context7.md +0 -371
  266. package/.agent/tools/context/dspy.md +0 -302
  267. package/.agent/tools/context/dspyground.md +0 -374
  268. package/.agent/tools/context/llm-tldr.md +0 -219
  269. package/.agent/tools/context/osgrep.md +0 -488
  270. package/.agent/tools/context/prompt-optimization.md +0 -338
  271. package/.agent/tools/context/toon.md +0 -292
  272. package/.agent/tools/conversion/pandoc.md +0 -304
  273. package/.agent/tools/credentials/api-key-management.md +0 -154
  274. package/.agent/tools/credentials/api-key-setup.md +0 -224
  275. package/.agent/tools/credentials/environment-variables.md +0 -180
  276. package/.agent/tools/credentials/vaultwarden.md +0 -382
  277. package/.agent/tools/data-extraction/outscraper.md +0 -974
  278. package/.agent/tools/deployment/coolify-cli.md +0 -388
  279. package/.agent/tools/deployment/coolify-setup.md +0 -353
  280. package/.agent/tools/deployment/coolify.md +0 -345
  281. package/.agent/tools/deployment/vercel.md +0 -390
  282. package/.agent/tools/git/authentication.md +0 -132
  283. package/.agent/tools/git/gitea-cli.md +0 -193
  284. package/.agent/tools/git/github-actions.md +0 -207
  285. package/.agent/tools/git/github-cli.md +0 -223
  286. package/.agent/tools/git/gitlab-cli.md +0 -190
  287. package/.agent/tools/git/opencode-github-security.md +0 -350
  288. package/.agent/tools/git/opencode-github.md +0 -328
  289. package/.agent/tools/git/opencode-gitlab.md +0 -252
  290. package/.agent/tools/git/security.md +0 -196
  291. package/.agent/tools/git.md +0 -207
  292. package/.agent/tools/opencode/oh-my-opencode.md +0 -375
  293. package/.agent/tools/opencode/opencode-anthropic-auth.md +0 -446
  294. package/.agent/tools/opencode/opencode.md +0 -651
  295. package/.agent/tools/social-media/bird.md +0 -437
  296. package/.agent/tools/task-management/beads.md +0 -336
  297. package/.agent/tools/terminal/terminal-title.md +0 -251
  298. package/.agent/tools/ui/shadcn.md +0 -196
  299. package/.agent/tools/ui/ui-skills.md +0 -115
  300. package/.agent/tools/wordpress/localwp.md +0 -311
  301. package/.agent/tools/wordpress/mainwp.md +0 -391
  302. package/.agent/tools/wordpress/scf.md +0 -527
  303. package/.agent/tools/wordpress/wp-admin.md +0 -729
  304. package/.agent/tools/wordpress/wp-dev.md +0 -940
  305. package/.agent/tools/wordpress/wp-preferred.md +0 -398
  306. package/.agent/tools/wordpress.md +0 -95
  307. package/.agent/workflows/branch/bugfix.md +0 -63
  308. package/.agent/workflows/branch/chore.md +0 -95
  309. package/.agent/workflows/branch/experiment.md +0 -115
  310. package/.agent/workflows/branch/feature.md +0 -59
  311. package/.agent/workflows/branch/hotfix.md +0 -98
  312. package/.agent/workflows/branch/refactor.md +0 -92
  313. package/.agent/workflows/branch/release.md +0 -96
  314. package/.agent/workflows/branch.md +0 -347
  315. package/.agent/workflows/bug-fixing.md +0 -267
  316. package/.agent/workflows/changelog.md +0 -129
  317. package/.agent/workflows/code-audit-remote.md +0 -279
  318. package/.agent/workflows/conversation-starter.md +0 -69
  319. package/.agent/workflows/error-feedback.md +0 -578
  320. package/.agent/workflows/feature-development.md +0 -355
  321. package/.agent/workflows/git-workflow.md +0 -702
  322. package/.agent/workflows/multi-repo-workspace.md +0 -268
  323. package/.agent/workflows/plans.md +0 -709
  324. package/.agent/workflows/postflight.md +0 -604
  325. package/.agent/workflows/pr.md +0 -571
  326. package/.agent/workflows/preflight.md +0 -278
  327. package/.agent/workflows/ralph-loop.md +0 -773
  328. package/.agent/workflows/release.md +0 -498
  329. package/.agent/workflows/session-manager.md +0 -254
  330. package/.agent/workflows/session-review.md +0 -311
  331. package/.agent/workflows/sql-migrations.md +0 -631
  332. package/.agent/workflows/version-bump.md +0 -283
  333. package/.agent/workflows/wiki-update.md +0 -333
  334. package/.agent/workflows/worktree.md +0 -477
@@ -1,69 +0,0 @@
1
- ---
2
- name: social-media
3
- description: Social media management - content scheduling, analytics, engagement, multi-platform strategy
4
- mode: subagent
5
- ---
6
-
7
- # Social Media - Main Agent
8
-
9
- <!-- AI-CONTEXT-START -->
10
-
11
- ## Quick Reference
12
-
13
- - **Purpose**: Social media management and strategy
14
- - **Platforms**: Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok
15
-
16
- **Typical Tasks**:
17
- - Content planning and scheduling
18
- - Engagement monitoring
19
- - Analytics and reporting
20
- - Multi-platform strategy
21
- - Audience growth
22
- - Hashtag research
23
- - Competitor analysis
24
-
25
- <!-- AI-CONTEXT-END -->
26
-
27
- ## Social Media Workflows
28
-
29
- ### Content Planning
30
-
31
- - Editorial calendar management
32
- - Content pillars and themes
33
- - Platform-specific formatting
34
- - Optimal posting times
35
- - Content repurposing across platforms
36
-
37
- ### Engagement
38
-
39
- - Community management
40
- - Response templates
41
- - Sentiment monitoring
42
- - Influencer identification
43
- - User-generated content curation
44
-
45
- ### Analytics
46
-
47
- - Performance metrics tracking
48
- - Audience insights
49
- - Competitor benchmarking
50
- - ROI measurement
51
- - Trend analysis
52
-
53
- ### Platform-Specific
54
-
55
- | Platform | Focus Areas |
56
- |----------|-------------|
57
- | Twitter/X | Real-time engagement, threads, hashtags |
58
- | LinkedIn | Professional content, thought leadership |
59
- | Facebook | Community building, groups, events |
60
- | Instagram | Visual content, stories, reels |
61
- | YouTube | Video SEO, thumbnails, descriptions |
62
- | TikTok | Short-form video, trends, sounds |
63
-
64
- ### Integration Points
65
-
66
- - `content.md` - Content creation workflows
67
- - `marketing.md` - Campaign coordination
68
- - `seo.md` - Keyword and hashtag research
69
- - `research.md` - Competitor and trend analysis
@@ -1,114 +0,0 @@
1
- ---
2
- mode: subagent
3
- ---
4
- # Execution Plans
5
-
6
- Complex, multi-session work requiring research, design decisions, and detailed tracking.
7
-
8
- Based on [OpenAI's PLANS.md](https://cookbook.openai.com/articles/codex_exec_plans) with TOON-enhanced parsing and [Beads](https://github.com/steveyegge/beads) integration for dependency visualization.
9
-
10
- <!--TOON:meta{version,format,updated}:
11
- 1.0,plans-md+toon,{{DATE}}
12
- -->
13
-
14
- ## Format
15
-
16
- Each plan includes:
17
- - **Plan ID**: `p001`, `p002`, etc. (for cross-referencing)
18
- - **Status**: Planning / In Progress (Phase X/Y) / Blocked / Completed
19
- - **Time Estimate**: `~2w (ai:1w test:0.5w read:0.5w)`
20
- - **Timestamps**: `logged:`, `started:`, `completed:`
21
- - **Dependencies**: `blocked-by:p001` or `blocks:p003`
22
- - **Linkage (The Pin)**: File:line references for search hit-rate (see below)
23
- - **Progress**: Timestamped checkboxes with estimates and actuals
24
- - **Decision Log**: Key decisions with rationale
25
- - **Surprises & Discoveries**: Unexpected findings
26
- - **Outcomes & Retrospective**: Results and lessons (when complete)
27
-
28
- ### Linkage (The Pin)
29
-
30
- Based on [Loom's spec-as-lookup-table pattern](https://ghuntley.com/ralph/), each plan should include a Linkage section that functions as a lookup table for AI search:
31
-
32
- | Concept | Files | Lines | Synonyms |
33
- |---------|-------|-------|----------|
34
- | {concept} | {file path} | {line range} | {related terms} |
35
-
36
- **Why this matters:**
37
- - Reduces hallucination by providing explicit anchors
38
- - Improves search hit-rate with synonyms
39
- - Points to exact file hunks for context
40
- - Prevents AI from inventing when it should reference
41
-
42
- ## Active Plans
43
-
44
- <!-- Add active plans here - see Plan Template below -->
45
-
46
- <!--TOON:active_plans[0]{id,title,status,phase,total_phases,owner,tags,est,est_ai,est_test,est_read,logged,started}:
47
- -->
48
-
49
- ## Completed Plans
50
-
51
- <!-- Move completed plans here with Outcomes & Retrospective -->
52
-
53
- <!--TOON:completed_plans[0]{id,title,owner,tags,est,actual,logged,started,completed,lead_time_days}:
54
- -->
55
-
56
- ## Archived Plans
57
-
58
- <!-- Plans that were abandoned or superseded -->
59
-
60
- <!--TOON:archived_plans[0]{id,title,reason,logged,archived}:
61
- -->
62
-
63
- ---
64
-
65
- ## Plan Template
66
-
67
- ```markdown
68
- ### p00X: Plan Title
69
-
70
- **Status:** Planning
71
- **Owner:** @username
72
- **Tags:** #tag1 #tag2
73
- **Estimate:** ~Xd (ai:Xd test:Xd read:Xd)
74
- **Dependencies:** blocked-by:p001 (if any)
75
- **PRD:** [todo/tasks/prd-{slug}.md](tasks/prd-{slug}.md)
76
- **Tasks:** [todo/tasks/tasks-{slug}.md](tasks/tasks-{slug}.md)
77
- **Logged:** YYYY-MM-DD
78
-
79
- #### Purpose
80
-
81
- Brief description of why this work matters.
82
-
83
- #### Linkage (The Pin)
84
-
85
- | Concept | Files | Lines | Synonyms |
86
- |---------|-------|-------|----------|
87
- | {main concept} | src/path/file.ts | 45-120 | {term1}, {term2} |
88
- | {related concept} | src/path/other.ts | 12-89 | {term3}, {term4} |
89
-
90
- #### Progress
91
-
92
- - [ ] (YYYY-MM-DD HH:MMZ) Phase 1: Description ~Xh
93
- - [ ] (YYYY-MM-DD HH:MMZ) Phase 2: Description ~Xh
94
-
95
- #### Decision Log
96
-
97
- (Decisions recorded during implementation)
98
-
99
- #### Surprises & Discoveries
100
-
101
- (Unexpected findings during implementation)
102
- ```
103
-
104
- ---
105
-
106
- ## Analytics
107
-
108
- <!--TOON:dependencies-->
109
- <!-- Format: child_id|relation|parent_id -->
110
- <!--/TOON:dependencies-->
111
-
112
- <!--TOON:analytics{total_plans,active,completed,archived,avg_lead_time_days,avg_variance_pct}:
113
- 0,0,0,0,,
114
- -->
@@ -1,129 +0,0 @@
1
- ---
2
- mode: subagent
3
- ---
4
- # Product Requirements Document: {Feature Name}
5
-
6
- Based on [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) PRD format, with time tracking.
7
-
8
- <!--TOON:prd{id,feature,author,status,est,est_ai,est_test,est_read,logged}:
9
- prd-{slug},{Feature Name},{Author},draft,{est},{est_ai},{est_test},{est_read},{YYYY-MM-DDTHH:MMZ}
10
- -->
11
-
12
- ## Overview
13
-
14
- **Feature:** {Feature name}
15
- **Author:** {Author}
16
- **Date:** {YYYY-MM-DD}
17
- **Status:** Draft | Review | Approved
18
- **Estimate:** ~{total} (ai:{ai_time} test:{test_time} read:{read_time})
19
-
20
- ### Problem Statement
21
-
22
- {What problem does this feature solve? Who experiences this problem?}
23
-
24
- ### Goal
25
-
26
- {What is the desired outcome? How will we know when this is successful?}
27
-
28
- ## User Stories
29
-
30
- ### Primary User Story
31
-
32
- As a {user type}, I want to {action} so that {benefit}.
33
-
34
- ### Additional User Stories
35
-
36
- - As a {user type}, I want to {action} so that {benefit}.
37
- - As a {user type}, I want to {action} so that {benefit}.
38
-
39
- ## Functional Requirements
40
-
41
- ### Core Requirements
42
-
43
- 1. **{Requirement 1}**: {Description}
44
- 2. **{Requirement 2}**: {Description}
45
- 3. **{Requirement 3}**: {Description}
46
-
47
- ### Secondary Requirements
48
-
49
- 4. **{Requirement 4}**: {Description}
50
- 5. **{Requirement 5}**: {Description}
51
-
52
- ## Non-Goals (Out of Scope)
53
-
54
- - {What this feature will NOT do}
55
- - {Explicitly excluded functionality}
56
- - {Future considerations not in this version}
57
-
58
- ## Design Considerations
59
-
60
- ### User Interface
61
-
62
- {UI/UX requirements, mockups, or references to existing patterns}
63
-
64
- ### User Experience
65
-
66
- {Flow description, interaction patterns}
67
-
68
- ## Technical Considerations
69
-
70
- ### Architecture
71
-
72
- {How this fits into existing architecture}
73
-
74
- ### Dependencies
75
-
76
- - {Dependency 1}: {Why needed}
77
- - {Dependency 2}: {Why needed}
78
-
79
- ### Constraints
80
-
81
- - {Technical constraint 1}
82
- - {Technical constraint 2}
83
-
84
- ### Security Considerations
85
-
86
- - {Security requirement 1}
87
- - {Security requirement 2}
88
-
89
- ## Time Estimate Breakdown
90
-
91
- | Phase | AI Time | Test Time | Read Time | Total |
92
- |-------|---------|-----------|-----------|-------|
93
- | Research | {Xh} | - | {Xh} | {Xh} |
94
- | Implementation | {Xh} | {Xh} | {Xm} | {Xh} |
95
- | Documentation | {Xm} | {Xm} | {Xm} | {Xh} |
96
- | **Total** | **{Xh}** | **{Xh}** | **{Xh}** | **{Xh}** |
97
-
98
- <!--TOON:time_breakdown[3]{phase,ai,test,read,total}:
99
- research,{Xh},,{Xh},{Xh}
100
- implementation,{Xh},{Xh},{Xm},{Xh}
101
- documentation,{Xm},{Xm},{Xm},{Xh}
102
- -->
103
-
104
- ## Success Metrics
105
-
106
- | Metric | Target | Measurement Method |
107
- |--------|--------|-------------------|
108
- | {Metric 1} | {Target value} | {How measured} |
109
- | {Metric 2} | {Target value} | {How measured} |
110
-
111
- ## Open Questions
112
-
113
- - [ ] {Question 1}
114
- - [ ] {Question 2}
115
- - [ ] {Question 3}
116
-
117
- ## Appendix
118
-
119
- ### Related Documents
120
-
121
- - {Link to related PRD}
122
- - {Link to design doc}
123
- - {Link to technical spec}
124
-
125
- ### Revision History
126
-
127
- | Date | Author | Changes |
128
- |------|--------|---------|
129
- | {YYYY-MM-DD} | {Author} | Initial draft |
@@ -1,108 +0,0 @@
1
- ---
2
- mode: subagent
3
- ---
4
- # Tasks: {Feature Name}
5
-
6
- Based on [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) task format, with time tracking.
7
-
8
- **PRD:** [prd-{slug}.md](prd-{slug}.md)
9
- **Created:** {YYYY-MM-DD}
10
- **Status:** Not Started | In Progress | Blocked | Complete
11
- **Estimate:** ~{total} (ai:{ai_time} test:{test_time} read:{read_time})
12
-
13
- <!--TOON:tasks_meta{id,feature,prd,status,est,est_ai,est_test,est_read,logged,started,completed}:
14
- tasks-{slug},{Feature Name},prd-{slug},not_started,{est},{est_ai},{est_test},{est_read},{YYYY-MM-DDTHH:MMZ},,
15
- -->
16
-
17
- ## Relevant Files
18
-
19
- - `path/to/file1.ts` - {Brief description of why this file is relevant}
20
- - `path/to/file1.test.ts` - Unit tests for file1.ts
21
- - `path/to/file2.ts` - {Brief description}
22
-
23
- ## Notes
24
-
25
- - Unit tests should be placed alongside the code files they test
26
- - Run tests with: `npm test` or `bun test` or project-specific command
27
- - Check off tasks as you complete them by changing `- [ ]` to `- [x]`
28
- - Time estimates use format: `~Xh (ai:Xh test:Xh)`
29
-
30
- ## Instructions
31
-
32
- **IMPORTANT:** As you complete each task, check it off by changing `- [ ]` to `- [x]`.
33
-
34
- Update after completing each sub-task, not just parent tasks.
35
-
36
- ## Tasks
37
-
38
- - [ ] 0.0 Create feature branch ~5m (ai:5m)
39
- - [ ] 0.1 Ensure on latest main: `git checkout main && git pull origin main`
40
- - [ ] 0.2 Create feature branch: `git checkout -b feature/{slug}`
41
-
42
- - [ ] 1.0 {First Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
43
- - [ ] 1.1 {Sub-task description} ~{Xm}
44
- - [ ] 1.2 {Sub-task description} ~{Xm}
45
- - [ ] 1.3 {Sub-task description} ~{Xm}
46
-
47
- - [ ] 2.0 {Second Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
48
- - [ ] 2.1 {Sub-task description} ~{Xm}
49
- - [ ] 2.2 {Sub-task description} ~{Xm}
50
-
51
- - [ ] 3.0 {Third Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
52
- - [ ] 3.1 {Sub-task description} ~{Xm}
53
- - [ ] 3.2 {Sub-task description} ~{Xm}
54
-
55
- - [ ] 4.0 Testing ~{Xh} (ai:{Xm} test:{Xh})
56
- - [ ] 4.1 Write unit tests for new functionality ~{Xm}
57
- - [ ] 4.2 Run full test suite and fix failures ~{Xm}
58
- - [ ] 4.3 Manual testing of feature ~{Xm}
59
-
60
- - [ ] 5.0 Documentation ~{Xm} (ai:{Xm} read:{Xm})
61
- - [ ] 5.1 Update relevant documentation ~{Xm}
62
- - [ ] 5.2 Add code comments where needed ~{Xm}
63
- - [ ] 5.3 Update CHANGELOG.md ~{Xm}
64
-
65
- - [ ] 6.0 Quality & Review ~{Xm} (ai:{Xm} test:{Xm})
66
- - [ ] 6.1 Run linters: `.agent/scripts/linters-local.sh` ~{Xm}
67
- - [ ] 6.2 Self-review code changes ~{Xm}
68
- - [ ] 6.3 Commit with descriptive message ~{Xm}
69
- - [ ] 6.4 Push branch and create PR ~{Xm}
70
-
71
- <!--TOON:tasks[7]{id,parent,desc,est,est_ai,est_test,status,actual,completed}:
72
- 0.0,,Create feature branch,5m,5m,,pending,,
73
- 1.0,,{First Parent Task},{Xh},{Xh},{Xh},pending,,
74
- 2.0,,{Second Parent Task},{Xh},{Xh},{Xh},pending,,
75
- 3.0,,{Third Parent Task},{Xh},{Xh},{Xh},pending,,
76
- 4.0,,Testing,{Xh},{Xm},{Xh},pending,,
77
- 5.0,,Documentation,{Xm},{Xm},,pending,,
78
- 6.0,,Quality & Review,{Xm},{Xm},{Xm},pending,,
79
- -->
80
-
81
- ## Time Tracking
82
-
83
- | Task | Estimated | Actual | Variance |
84
- |------|-----------|--------|----------|
85
- | 0.0 Create branch | 5m | - | - |
86
- | 1.0 {Task 1} | {Xh} | - | - |
87
- | 2.0 {Task 2} | {Xh} | - | - |
88
- | 3.0 {Task 3} | {Xh} | - | - |
89
- | 4.0 Testing | {Xh} | - | - |
90
- | 5.0 Documentation | {Xm} | - | - |
91
- | 6.0 Quality | {Xm} | - | - |
92
- | **Total** | **{Xh}** | **-** | **-** |
93
-
94
- <!--TOON:time_summary{total_est,total_actual,variance_pct}:
95
- {Xh},,
96
- -->
97
-
98
- ## Completion Checklist
99
-
100
- Before marking this task list complete:
101
-
102
- - [ ] All tasks checked off
103
- - [ ] Tests passing
104
- - [ ] Linters passing
105
- - [ ] Documentation updated
106
- - [ ] CHANGELOG.md updated
107
- - [ ] PR created and ready for review
108
- - [ ] Time actuals recorded
@@ -1,89 +0,0 @@
1
- ---
2
- mode: subagent
3
- ---
4
- # TODO
5
-
6
- Project task tracking with time estimates, dependencies, and TOON-enhanced parsing.
7
-
8
- Compatible with [todo-md](https://github.com/todo-md/todo-md), [todomd](https://github.com/todomd/todo.md), [taskell](https://github.com/smallhadroncollider/taskell), and [Beads](https://github.com/steveyegge/beads).
9
-
10
- ## Format
11
-
12
- **Human-readable:**
13
-
14
- ```markdown
15
- - [ ] t001 Task description @owner #tag ~4h (ai:2h test:1h read:30m) logged:2025-01-15
16
- - [ ] t002 Dependent task blocked-by:t001 ~2h
17
- - [ ] t001.1 Subtask of t001 ~1h
18
- - [x] t003 Completed task ~2h actual:1.5h logged:2025-01-10 completed:2025-01-15
19
- - [-] Declined task
20
- ```
21
-
22
- **Task IDs:**
23
- - `t001` - Top-level task
24
- - `t001.1` - Subtask of t001
25
- - `t001.1.1` - Sub-subtask
26
-
27
- **Dependencies:**
28
- - `blocked-by:t001` - This task waits for t001
29
- - `blocked-by:t001,t002` - Waits for multiple tasks
30
- - `blocks:t003` - This task blocks t003
31
-
32
- **Time fields:**
33
- - `~estimate` - Total time with optional breakdown `(ai:Xh test:Xh read:Xm)`
34
- - `actual:` - Actual time spent (recorded at commit/release)
35
- - `logged:` - When task was added
36
- - `started:` - When branch was created
37
- - `completed:` - When task was marked done
38
-
39
- <!--TOON:meta{version,format,updated}:
40
- 1.0,todo-md+toon,{{DATE}}
41
- -->
42
-
43
- ## Ready
44
-
45
- <!-- Tasks with no open blockers - run /ready to refresh -->
46
-
47
- <!--TOON:ready[0]{id,desc,owner,tags,est,logged,status}:
48
- -->
49
-
50
- ## Backlog
51
-
52
- <!--TOON:backlog[0]{id,desc,owner,tags,est,est_ai,est_test,est_read,logged,status}:
53
- -->
54
-
55
- ## In Progress
56
-
57
- <!--TOON:in_progress[0]{id,desc,owner,tags,est,est_ai,est_test,est_read,logged,started,status}:
58
- -->
59
-
60
- ## In Review
61
-
62
- <!-- Tasks with open PRs awaiting merge -->
63
-
64
- <!--TOON:in_review[0]{id,desc,owner,tags,est,pr_url,started,pr_created,status}:
65
- -->
66
-
67
- ## Done
68
-
69
- <!--TOON:done[0]{id,desc,owner,tags,est,actual,logged,started,completed,status}:
70
- -->
71
-
72
- ## Declined
73
-
74
- <!-- Tasks that were considered but decided against -->
75
-
76
- <!--TOON:declined[0]{id,desc,reason,logged,status}:
77
- -->
78
-
79
- <!--TOON:dependencies-->
80
- <!-- Format: child_id|relation|parent_id -->
81
- <!--/TOON:dependencies-->
82
-
83
- <!--TOON:subtasks-->
84
- <!-- Format: parent_id|child_ids (comma-separated) -->
85
- <!--/TOON:subtasks-->
86
-
87
- <!--TOON:summary{total,ready,pending,in_progress,in_review,done,declined,total_est,total_actual}:
88
- 0,0,0,0,0,0,0,,
89
- -->