aidevops 2.52.1

package/.agent/social-media.md

@@ -0,0 +1,69 @@
+---
+name: social-media
+description: Social media management - content scheduling, analytics, engagement, multi-platform strategy
+mode: subagent
+---
+
+# Social Media - Main Agent
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: Social media management and strategy
+- **Platforms**: Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok
+
+**Typical Tasks**:
+- Content planning and scheduling
+- Engagement monitoring
+- Analytics and reporting
+- Multi-platform strategy
+- Audience growth
+- Hashtag research
+- Competitor analysis
+
+<!-- AI-CONTEXT-END -->
+
+## Social Media Workflows
+
+### Content Planning
+
+- Editorial calendar management
+- Content pillars and themes
+- Platform-specific formatting
+- Optimal posting times
+- Content repurposing across platforms
+
+### Engagement
+
+- Community management
+- Response templates
+- Sentiment monitoring
+- Influencer identification
+- User-generated content curation
+
+### Analytics
+
+- Performance metrics tracking
+- Audience insights
+- Competitor benchmarking
+- ROI measurement
+- Trend analysis
+
+### Platform-Specific
+
+| Platform | Focus Areas |
+|----------|-------------|
+| Twitter/X | Real-time engagement, threads, hashtags |
+| LinkedIn | Professional content, thought leadership |
+| Facebook | Community building, groups, events |
+| Instagram | Visual content, stories, reels |
+| YouTube | Video SEO, thumbnails, descriptions |
+| TikTok | Short-form video, trends, sounds |
+
+### Integration Points
+
+- `content.md` - Content creation workflows
+- `marketing.md` - Campaign coordination
+- `seo.md` - Keyword and hashtag research
+- `research.md` - Competitor and trend analysis

package/.agent/templates/plans-template.md

@@ -0,0 +1,114 @@
+---
+mode: subagent
+---
+# Execution Plans
+
+Complex, multi-session work requiring research, design decisions, and detailed tracking.
+
+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.
+
+<!--TOON:meta{version,format,updated}:
+1.0,plans-md+toon,{{DATE}}
+-->
+
+## Format
+
+Each plan includes:
+- **Plan ID**: `p001`, `p002`, etc. (for cross-referencing)
+- **Status**: Planning / In Progress (Phase X/Y) / Blocked / Completed
+- **Time Estimate**: `~2w (ai:1w test:0.5w read:0.5w)`
+- **Timestamps**: `logged:`, `started:`, `completed:`
+- **Dependencies**: `blocked-by:p001` or `blocks:p003`
+- **Linkage (The Pin)**: File:line references for search hit-rate (see below)
+- **Progress**: Timestamped checkboxes with estimates and actuals
+- **Decision Log**: Key decisions with rationale
+- **Surprises & Discoveries**: Unexpected findings
+- **Outcomes & Retrospective**: Results and lessons (when complete)
+
+### Linkage (The Pin)
+
+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:
+
+| Concept | Files | Lines | Synonyms |
+|---------|-------|-------|----------|
+| {concept} | {file path} | {line range} | {related terms} |
+
+**Why this matters:**
+- Reduces hallucination by providing explicit anchors
+- Improves search hit-rate with synonyms
+- Points to exact file hunks for context
+- Prevents AI from inventing when it should reference
+
+## Active Plans
+
+<!-- Add active plans here - see Plan Template below -->
+
+<!--TOON:active_plans[0]{id,title,status,phase,total_phases,owner,tags,est,est_ai,est_test,est_read,logged,started}:
+-->
+
+## Completed Plans
+
+<!-- Move completed plans here with Outcomes & Retrospective -->
+
+<!--TOON:completed_plans[0]{id,title,owner,tags,est,actual,logged,started,completed,lead_time_days}:
+-->
+
+## Archived Plans
+
+<!-- Plans that were abandoned or superseded -->
+
+<!--TOON:archived_plans[0]{id,title,reason,logged,archived}:
+-->
+
+---
+
+## Plan Template
+
+```markdown
+### p00X: Plan Title
+
+**Status:** Planning
+**Owner:** @username
+**Tags:** #tag1 #tag2
+**Estimate:** ~Xd (ai:Xd test:Xd read:Xd)
+**Dependencies:** blocked-by:p001 (if any)
+**PRD:** [todo/tasks/prd-{slug}.md](tasks/prd-{slug}.md)
+**Tasks:** [todo/tasks/tasks-{slug}.md](tasks/tasks-{slug}.md)
+**Logged:** YYYY-MM-DD
+
+#### Purpose
+
+Brief description of why this work matters.
+
+#### Linkage (The Pin)
+
+| Concept | Files | Lines | Synonyms |
+|---------|-------|-------|----------|
+| {main concept} | src/path/file.ts | 45-120 | {term1}, {term2} |
+| {related concept} | src/path/other.ts | 12-89 | {term3}, {term4} |
+
+#### Progress
+
+- [ ] (YYYY-MM-DD HH:MMZ) Phase 1: Description ~Xh
+- [ ] (YYYY-MM-DD HH:MMZ) Phase 2: Description ~Xh
+
+#### Decision Log
+
+(Decisions recorded during implementation)
+
+#### Surprises & Discoveries
+
+(Unexpected findings during implementation)
+```
+
+---
+
+## Analytics
+
+<!--TOON:dependencies-->
+<!-- Format: child_id|relation|parent_id -->
+<!--/TOON:dependencies-->
+
+<!--TOON:analytics{total_plans,active,completed,archived,avg_lead_time_days,avg_variance_pct}:
+0,0,0,0,,
+-->

package/.agent/templates/prd-template.md

@@ -0,0 +1,129 @@
+---
+mode: subagent
+---
+# Product Requirements Document: {Feature Name}
+
+Based on [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) PRD format, with time tracking.
+
+<!--TOON:prd{id,feature,author,status,est,est_ai,est_test,est_read,logged}:
+prd-{slug},{Feature Name},{Author},draft,{est},{est_ai},{est_test},{est_read},{YYYY-MM-DDTHH:MMZ}
+-->
+
+## Overview
+
+**Feature:** {Feature name}
+**Author:** {Author}
+**Date:** {YYYY-MM-DD}
+**Status:** Draft | Review | Approved
+**Estimate:** ~{total} (ai:{ai_time} test:{test_time} read:{read_time})
+
+### Problem Statement
+
+{What problem does this feature solve? Who experiences this problem?}
+
+### Goal
+
+{What is the desired outcome? How will we know when this is successful?}
+
+## User Stories
+
+### Primary User Story
+
+As a {user type}, I want to {action} so that {benefit}.
+
+### Additional User Stories
+
+- As a {user type}, I want to {action} so that {benefit}.
+- As a {user type}, I want to {action} so that {benefit}.
+
+## Functional Requirements
+
+### Core Requirements
+
+1. **{Requirement 1}**: {Description}
+2. **{Requirement 2}**: {Description}
+3. **{Requirement 3}**: {Description}
+
+### Secondary Requirements
+
+4. **{Requirement 4}**: {Description}
+5. **{Requirement 5}**: {Description}
+
+## Non-Goals (Out of Scope)
+
+- {What this feature will NOT do}
+- {Explicitly excluded functionality}
+- {Future considerations not in this version}
+
+## Design Considerations
+
+### User Interface
+
+{UI/UX requirements, mockups, or references to existing patterns}
+
+### User Experience
+
+{Flow description, interaction patterns}
+
+## Technical Considerations
+
+### Architecture
+
+{How this fits into existing architecture}
+
+### Dependencies
+
+- {Dependency 1}: {Why needed}
+- {Dependency 2}: {Why needed}
+
+### Constraints
+
+- {Technical constraint 1}
+- {Technical constraint 2}
+
+### Security Considerations
+
+- {Security requirement 1}
+- {Security requirement 2}
+
+## Time Estimate Breakdown
+
+| Phase | AI Time | Test Time | Read Time | Total |
+|-------|---------|-----------|-----------|-------|
+| Research | {Xh} | - | {Xh} | {Xh} |
+| Implementation | {Xh} | {Xh} | {Xm} | {Xh} |
+| Documentation | {Xm} | {Xm} | {Xm} | {Xh} |
+| **Total** | **{Xh}** | **{Xh}** | **{Xh}** | **{Xh}** |
+
+<!--TOON:time_breakdown[3]{phase,ai,test,read,total}:
+research,{Xh},,{Xh},{Xh}
+implementation,{Xh},{Xh},{Xm},{Xh}
+documentation,{Xm},{Xm},{Xm},{Xh}
+-->
+
+## Success Metrics
+
+| Metric | Target | Measurement Method |
+|--------|--------|-------------------|
+| {Metric 1} | {Target value} | {How measured} |
+| {Metric 2} | {Target value} | {How measured} |
+
+## Open Questions
+
+- [ ] {Question 1}
+- [ ] {Question 2}
+- [ ] {Question 3}
+
+## Appendix
+
+### Related Documents
+
+- {Link to related PRD}
+- {Link to design doc}
+- {Link to technical spec}
+
+### Revision History
+
+| Date | Author | Changes |
+|------|--------|---------|
+| {YYYY-MM-DD} | {Author} | Initial draft |

package/.agent/templates/tasks-template.md

@@ -0,0 +1,108 @@
+---
+mode: subagent
+---
+# Tasks: {Feature Name}
+
+Based on [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) task format, with time tracking.
+
+**PRD:** [prd-{slug}.md](prd-{slug}.md)
+**Created:** {YYYY-MM-DD}
+**Status:** Not Started | In Progress | Blocked | Complete
+**Estimate:** ~{total} (ai:{ai_time} test:{test_time} read:{read_time})
+
+<!--TOON:tasks_meta{id,feature,prd,status,est,est_ai,est_test,est_read,logged,started,completed}:
+tasks-{slug},{Feature Name},prd-{slug},not_started,{est},{est_ai},{est_test},{est_read},{YYYY-MM-DDTHH:MMZ},,
+-->
+
+## Relevant Files
+
+- `path/to/file1.ts` - {Brief description of why this file is relevant}
+- `path/to/file1.test.ts` - Unit tests for file1.ts
+- `path/to/file2.ts` - {Brief description}
+
+## Notes
+
+- Unit tests should be placed alongside the code files they test
+- Run tests with: `npm test` or `bun test` or project-specific command
+- Check off tasks as you complete them by changing `- [ ]` to `- [x]`
+- Time estimates use format: `~Xh (ai:Xh test:Xh)`
+
+## Instructions
+
+**IMPORTANT:** As you complete each task, check it off by changing `- [ ]` to `- [x]`.
+
+Update after completing each sub-task, not just parent tasks.
+
+## Tasks
+
+- [ ] 0.0 Create feature branch ~5m (ai:5m)
+  - [ ] 0.1 Ensure on latest main: `git checkout main && git pull origin main`
+  - [ ] 0.2 Create feature branch: `git checkout -b feature/{slug}`
+
+- [ ] 1.0 {First Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
+  - [ ] 1.1 {Sub-task description} ~{Xm}
+  - [ ] 1.2 {Sub-task description} ~{Xm}
+  - [ ] 1.3 {Sub-task description} ~{Xm}
+
+- [ ] 2.0 {Second Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
+  - [ ] 2.1 {Sub-task description} ~{Xm}
+  - [ ] 2.2 {Sub-task description} ~{Xm}
+
+- [ ] 3.0 {Third Parent Task} ~{Xh} (ai:{Xh} test:{Xh})
+  - [ ] 3.1 {Sub-task description} ~{Xm}
+  - [ ] 3.2 {Sub-task description} ~{Xm}
+
+- [ ] 4.0 Testing ~{Xh} (ai:{Xm} test:{Xh})
+  - [ ] 4.1 Write unit tests for new functionality ~{Xm}
+  - [ ] 4.2 Run full test suite and fix failures ~{Xm}
+  - [ ] 4.3 Manual testing of feature ~{Xm}
+
+- [ ] 5.0 Documentation ~{Xm} (ai:{Xm} read:{Xm})
+  - [ ] 5.1 Update relevant documentation ~{Xm}
+  - [ ] 5.2 Add code comments where needed ~{Xm}
+  - [ ] 5.3 Update CHANGELOG.md ~{Xm}
+
+- [ ] 6.0 Quality & Review ~{Xm} (ai:{Xm} test:{Xm})
+  - [ ] 6.1 Run linters: `.agent/scripts/linters-local.sh` ~{Xm}
+  - [ ] 6.2 Self-review code changes ~{Xm}
+  - [ ] 6.3 Commit with descriptive message ~{Xm}
+  - [ ] 6.4 Push branch and create PR ~{Xm}
+
+<!--TOON:tasks[7]{id,parent,desc,est,est_ai,est_test,status,actual,completed}:
+0.0,,Create feature branch,5m,5m,,pending,,
+1.0,,{First Parent Task},{Xh},{Xh},{Xh},pending,,
+2.0,,{Second Parent Task},{Xh},{Xh},{Xh},pending,,
+3.0,,{Third Parent Task},{Xh},{Xh},{Xh},pending,,
+4.0,,Testing,{Xh},{Xm},{Xh},pending,,
+5.0,,Documentation,{Xm},{Xm},,pending,,
+6.0,,Quality & Review,{Xm},{Xm},{Xm},pending,,
+-->
+
+## Time Tracking
+
+| Task | Estimated | Actual | Variance |
+|------|-----------|--------|----------|
+| 0.0 Create branch | 5m | - | - |
+| 1.0 {Task 1} | {Xh} | - | - |
+| 2.0 {Task 2} | {Xh} | - | - |
+| 3.0 {Task 3} | {Xh} | - | - |
+| 4.0 Testing | {Xh} | - | - |
+| 5.0 Documentation | {Xm} | - | - |
+| 6.0 Quality | {Xm} | - | - |
+| **Total** | **{Xh}** | **-** | **-** |
+
+<!--TOON:time_summary{total_est,total_actual,variance_pct}:
+{Xh},,
+-->
+
+## Completion Checklist
+
+Before marking this task list complete:
+
+- [ ] All tasks checked off
+- [ ] Tests passing
+- [ ] Linters passing
+- [ ] Documentation updated
+- [ ] CHANGELOG.md updated
+- [ ] PR created and ready for review
+- [ ] Time actuals recorded

package/.agent/templates/todo-template.md

@@ -0,0 +1,89 @@
+---
+mode: subagent
+---
+# TODO
+
+Project task tracking with time estimates, dependencies, and TOON-enhanced parsing.
+
+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).
+
+## Format
+
+**Human-readable:**
+
+```markdown
+- [ ] t001 Task description @owner #tag ~4h (ai:2h test:1h read:30m) logged:2025-01-15
+- [ ] t002 Dependent task blocked-by:t001 ~2h
+- [ ] t001.1 Subtask of t001 ~1h
+- [x] t003 Completed task ~2h actual:1.5h logged:2025-01-10 completed:2025-01-15
+- [-] Declined task
+```
+
+**Task IDs:**
+- `t001` - Top-level task
+- `t001.1` - Subtask of t001
+- `t001.1.1` - Sub-subtask
+
+**Dependencies:**
+- `blocked-by:t001` - This task waits for t001
+- `blocked-by:t001,t002` - Waits for multiple tasks
+- `blocks:t003` - This task blocks t003
+
+**Time fields:**
+- `~estimate` - Total time with optional breakdown `(ai:Xh test:Xh read:Xm)`
+- `actual:` - Actual time spent (recorded at commit/release)
+- `logged:` - When task was added
+- `started:` - When branch was created
+- `completed:` - When task was marked done
+
+<!--TOON:meta{version,format,updated}:
+1.0,todo-md+toon,{{DATE}}
+-->
+
+## Ready
+
+<!-- Tasks with no open blockers - run /ready to refresh -->
+
+<!--TOON:ready[0]{id,desc,owner,tags,est,logged,status}:
+-->
+
+## Backlog
+
+<!--TOON:backlog[0]{id,desc,owner,tags,est,est_ai,est_test,est_read,logged,status}:
+-->
+
+## In Progress
+
+<!--TOON:in_progress[0]{id,desc,owner,tags,est,est_ai,est_test,est_read,logged,started,status}:
+-->
+
+## In Review
+
+<!-- Tasks with open PRs awaiting merge -->
+
+<!--TOON:in_review[0]{id,desc,owner,tags,est,pr_url,started,pr_created,status}:
+-->
+
+## Done
+
+<!--TOON:done[0]{id,desc,owner,tags,est,actual,logged,started,completed,status}:
+-->
+
+## Declined
+
+<!-- Tasks that were considered but decided against -->
+
+<!--TOON:declined[0]{id,desc,reason,logged,status}:
+-->
+
+<!--TOON:dependencies-->
+<!-- Format: child_id|relation|parent_id -->
+<!--/TOON:dependencies-->
+
+<!--TOON:subtasks-->
+<!-- Format: parent_id|child_ids (comma-separated) -->
+<!--/TOON:subtasks-->
+
+<!--TOON:summary{total,ready,pending,in_progress,in_review,done,declined,total_est,total_actual}:
+0,0,0,0,0,0,0,,
+-->