agentic-forge 0.0.0

package/src/workflows/analyze-codebase.yaml

@@ -0,0 +1,196 @@
+name: analyze-codebase
+version: "1.0"
+description: Run comprehensive codebase analysis with optional autofix in parallel worktrees
+
+settings:
+  max-retry: 2
+  timeout-minutes: 120
+  track-progress: true
+  terminal-output: base
+
+variables:
+  - name: autofix
+    type: string
+    required: false
+    default: "none"
+    description: Severity level for automatic fixes (none, minor, major, critical)
+  - name: paths
+    type: string
+    required: false
+    default: ""
+    description: Space-separated list of paths to analyze (optional)
+  - name: create_pr
+    type: boolean
+    required: false
+    default: false
+    description: Whether to create a PR for each analysis branch
+  - name: max_fix_iterations
+    type: number
+    required: false
+    default: 25
+    description: Maximum iterations per analysis type for fixing issues
+
+steps:
+  - name: analyze-and-fix-all
+    type: parallel
+    merge-strategy: wait-all
+    merge-mode: independent
+    git:
+      worktree: true
+      branch-prefix: "agentic/analysis"
+    steps:
+      - name: bug-analysis
+        type: serial
+        steps:
+          - name: analyze-bug
+            type: prompt
+            prompt: /af-analyze bug {{ variables.paths }}
+
+          - name: fix-bug
+            type: conditional
+            condition: "variables.autofix != 'none'"
+            then:
+              - name: apply-bug-fixes
+                type: ralph-loop
+                max-iterations: "{{ variables.max_fix_iterations }}"
+                completion-promise: "BUG_FIXES_COMPLETE"
+                model: sonnet
+                timeout-minutes: 30
+                prompt: |
+                  Use /af-fix-analyze bug {{ variables.autofix }}
+
+                  Return completion promise "BUG_FIXES_COMPLETE" when done.
+
+          - name: create-bug-pr
+            type: conditional
+            condition: "variables.create_pr"
+            then:
+              - name: open-bug-pr
+                type: prompt
+                prompt: /af-git-pr "[Analysis] Bug analysis and fixes"
+
+      - name: debt-analysis
+        type: serial
+        steps:
+          - name: analyze-debt
+            type: prompt
+            prompt: /af-analyze debt {{ variables.paths }}
+
+          - name: fix-debt
+            type: conditional
+            condition: "variables.autofix != 'none'"
+            then:
+              - name: apply-debt-fixes
+                type: ralph-loop
+                max-iterations: "{{ variables.max_fix_iterations }}"
+                completion-promise: "DEBT_FIXES_COMPLETE"
+                model: sonnet
+                timeout-minutes: 30
+                prompt: |
+                  Use /af-fix-analyze debt {{ variables.autofix }}
+
+                  Return completion promise "DEBT_FIXES_COMPLETE" when done.
+
+          - name: create-debt-pr
+            type: conditional
+            condition: "variables.create_pr"
+            then:
+              - name: open-debt-pr
+                type: prompt
+                prompt: /af-git-pr "[Analysis] Technical debt analysis and fixes"
+
+      - name: doc-analysis
+        type: serial
+        steps:
+          - name: analyze-doc
+            type: prompt
+            prompt: /af-analyze doc {{ variables.paths }}
+
+          - name: fix-doc
+            type: conditional
+            condition: "variables.autofix != 'none'"
+            then:
+              - name: apply-doc-fixes
+                type: ralph-loop
+                max-iterations: "{{ variables.max_fix_iterations }}"
+                completion-promise: "DOC_FIXES_COMPLETE"
+                model: sonnet
+                timeout-minutes: 30
+                prompt: |
+                  Use /af-fix-analyze doc {{ variables.autofix }}
+
+                  Return completion promise "DOC_FIXES_COMPLETE" when done.
+
+          - name: create-doc-pr
+            type: conditional
+            condition: "variables.create_pr"
+            then:
+              - name: open-doc-pr
+                type: prompt
+                prompt: /af-git-pr "[Analysis] Documentation analysis and fixes"
+
+      - name: security-analysis
+        type: serial
+        steps:
+          - name: analyze-security
+            type: prompt
+            prompt: /af-analyze security {{ variables.paths }}
+
+          - name: fix-security
+            type: conditional
+            condition: "variables.autofix != 'none'"
+            then:
+              - name: apply-security-fixes
+                type: ralph-loop
+                max-iterations: "{{ variables.max_fix_iterations }}"
+                completion-promise: "SECURITY_FIXES_COMPLETE"
+                model: sonnet
+                timeout-minutes: 30
+                prompt: |
+                  Use /af-fix-analyze security {{ variables.autofix }}
+
+                  Return completion promise "SECURITY_FIXES_COMPLETE" when done.
+
+          - name: create-security-pr
+            type: conditional
+            condition: "variables.create_pr"
+            then:
+              - name: open-security-pr
+                type: prompt
+                prompt: /af-git-pr "[Analysis] Security analysis and fixes"
+
+      - name: style-analysis
+        type: serial
+        steps:
+          - name: analyze-style
+            type: prompt
+            prompt: /af-analyze style {{ variables.paths }}
+
+          - name: fix-style
+            type: conditional
+            condition: "variables.autofix != 'none'"
+            then:
+              - name: apply-style-fixes
+                type: ralph-loop
+                max-iterations: "{{ variables.max_fix_iterations }}"
+                completion-promise: "STYLE_FIXES_COMPLETE"
+                model: sonnet
+                timeout-minutes: 30
+                prompt: |
+                  Use /af-fix-analyze style {{ variables.autofix }}
+
+                  Return completion promise "STYLE_FIXES_COMPLETE" when done.
+
+          - name: create-style-pr
+            type: conditional
+            condition: "variables.create_pr"
+            then:
+              - name: open-style-pr
+                type: prompt
+                prompt: /af-git-pr "[Analysis] Style analysis and fixes"
+
+outputs:
+  - name: analysis-summary
+    template: analysis-summary.md.j2
+    path: summary.md
+    when: completed

package/src/workflows/analyze-single.yaml

@@ -0,0 +1,56 @@
+name: analyze-single
+version: "1.0"
+description: Run a single type of codebase analysis with optional autofix
+
+settings:
+  max-retry: 2
+  timeout-minutes: 60
+  track-progress: true
+  terminal-output: base
+
+variables:
+  - name: analysis_type
+    type: string
+    required: true
+    description: Type of analysis to run (bug, debt, doc, security, style)
+  - name: autofix
+    type: string
+    required: false
+    default: "none"
+    description: Severity level for automatic fixes (none, low, medium, high, critical)
+  - name: paths
+    type: string
+    required: false
+    default: ""
+    description: Space-separated list of paths to analyze (optional)
+  - name: max_fix_iterations
+    type: number
+    required: false
+    default: 25
+    description: Maximum iterations for fixing issues
+
+steps:
+  - name: run-analysis
+    type: prompt
+    prompt: /af-analyze {{ variables.analysis_type }} {{ variables.paths }}
+
+  - name: check-autofix
+    type: conditional
+    condition: "variables.autofix != 'none'"
+    then:
+      - name: fix-issues
+        type: ralph-loop
+        max-iterations: "{{ variables.max_fix_iterations }}"
+        completion-promise: "ANALYSIS_FIXES_COMPLETE"
+        model: sonnet
+        timeout-minutes: 30
+        prompt: |
+          Use /af-fix-analyze {{ variables.analysis_type }} {{ variables.autofix }}
+
+          Return completion promise "ANALYSIS_FIXES_COMPLETE" when done.
+
+outputs:
+  - name: analysis-report
+    template: analysis/{{ variables.analysis_type }}.md.j2
+    path: "{{ variables.analysis_type }}.md"
+    when: completed

package/src/workflows/demo.yaml

@@ -0,0 +1,180 @@
+name: demo
+version: "1.0"
+description: Demo workflow to validate agentic-forge plugin installation and configuration
+
+settings:
+  track-progress: true
+  terminal-output: all
+  bypass-permissions: false
+  required-tools:
+    - Write
+    - Read
+    - Bash
+  git:
+    enabled: false
+    worktree: false
+
+steps:
+  - name: welcome
+    type: prompt
+    model: haiku
+    prompt: |
+      # Welcome to the agentic-forge Demo Workflow
+
+      This is a demonstration workflow that validates your agentic-forge plugin installation.
+
+      Please acknowledge this welcome message by saying: "Demo workflow started successfully."
+
+  - name: create-demo-files
+    type: parallel
+    merge-strategy: wait-all
+    merge-mode: independent
+    git:
+      worktree: false
+    steps:
+      - name: create-demo-1
+        type: prompt
+        model: haiku
+        prompt: |
+          Create a file named `demo-1.md` at the repository root.
+
+          The file should contain:
+          ```markdown
+          # Demo File 1
+
+          Created by: agentic-forge demo
+          Timestamp: [current timestamp]
+          Step: create-demo-1
+
+          This file was created to validate the workflow execution.
+          ```
+
+          Use the Write tool to create this file.
+
+          IMPORTANT: If you encounter a permission error when trying to write this file,
+          you MUST stop immediately and report: "PERMISSION ERROR: Unable to write demo-1.md"
+          Do not attempt any workarounds.
+
+      - name: create-demo-2
+        type: prompt
+        model: haiku
+        prompt: |
+          Create a file named `demo-2.md` at the repository root.
+
+          The file should contain:
+          ```markdown
+          # Demo File 2
+
+          Created by: agentic-forge demo
+          Timestamp: [current timestamp]
+          Step: create-demo-2
+
+          This file was created to validate the workflow execution.
+          ```
+
+          Use the Write tool to create this file.
+
+          IMPORTANT: If you encounter a permission error when trying to write this file,
+          you MUST stop immediately and report: "PERMISSION ERROR: Unable to write demo-2.md"
+          Do not attempt any workarounds.
+
+  - name: random-facts-loop
+    type: ralph-loop
+    model: haiku
+    max-iterations: 5
+    completion-promise: THREE_FACTS_WRITTEN
+    prompt: |
+      ## Random Facts Loop - Iteration {{iteration}}/{{max_iterations}}
+
+      You are in a Ralph Wiggum iterative loop adding random knowledge facts to demo-1.md.
+
+      ## Your Task
+      1. Read the file `demo-1.md` at the repository root
+      2. Add ONE new numbered random knowledge fact to the "Random Facts" section
+      3. If the "Random Facts" section does not exist, create it at the end of the file
+      4. Save the file and STOP (exit the session)
+
+      ## Random Facts Section Format
+      ```markdown
+      ## Random Facts
+
+      1. [Your first random fact here]
+      2. [Your second random fact here]
+      ...
+      ```
+
+      ## Exit Instructions
+      - After adding ONE fact, you MUST exit the session immediately
+      - Do NOT add multiple facts in a single iteration
+      - Simply stop working after saving the file - the loop will automatically continue
+
+      ## Completion Condition
+      When the file contains EXACTLY 3 numbered facts in the Random Facts section, output:
+      ```json
+      {"ralph_complete": true, "promise": "THREE_FACTS_WRITTEN"}
+      ```
+
+      **IMPORTANT**:
+      - Count the existing facts BEFORE adding a new one
+      - If there are already 2 facts, add the 3rd fact and THEN output the completion JSON
+      - If there are already 3 or more facts, output the completion JSON immediately without adding more
+      - If there are 0-1 facts, add ONE fact and then STOP (do not output completion JSON yet)
+
+  - name: git-branch
+    type: prompt
+    model: haiku
+    prompt: /af-git-branch demo random-facts
+
+  - name: git-commit
+    type: prompt
+    model: haiku
+    prompt: /af-git-commit "[Demo] Add demo files with random facts"
+
+  - name: completion
+    type: prompt
+    model: haiku
+    prompt: |
+      # Demo Workflow Complete
+
+      The agentic-forge demo workflow has finished executing.
+
+      ## Validation Tasks
+
+      You MUST verify ALL of the following before reporting completion:
+
+      ### 1. File Validation
+      - Read `demo-1.md` and verify it exists at the repository root
+      - Read `demo-2.md` and verify it exists at the repository root
+
+      ### 2. Random Facts Validation
+      - Verify that `demo-1.md` contains a "Random Facts" section with EXACTLY 3 numbered facts
+      - Count the facts to confirm there are 3
+
+      ### 3. Git Branch Validation
+      - Run `git branch --show-current` to check the current branch
+      - Verify the current branch is `demo/random-facts`
+
+      ### 4. Git Commit Validation
+      - Run `git log -1 --oneline` to check the most recent commit
+      - Verify a commit exists with a message containing "demo" or "random facts"
+
+      ## Reporting
+
+      After performing ALL validations, report the results:
+
+      If ALL validations passed, say:
+      "DEMO WORKFLOW COMPLETED SUCCESSFULLY - Your agentic-forge installation is working correctly!
+
+      Validation Summary:
+      - demo-1.md: Created with 3 random facts
+      - demo-2.md: Created
+      - Git branch: demo/random-facts
+      - Git commit: [commit message]"
+
+      If ANY validation failed, report which ones and end with:
+      "DEMO WORKFLOW COMPLETED WITH ISSUES - Please review the errors above."
+
+      Remind the user to clean up by running:
+      - `git checkout main`
+      - `git branch -D demo/random-facts`
+      - Delete demo-1.md and demo-2.md

package/src/workflows/one-shot.yaml

@@ -0,0 +1,54 @@
+name: one-shot
+version: "1.0"
+description: Complete a single task from start to finish with PR
+
+settings:
+  max-retry: 3
+  timeout-minutes: 60
+  track-progress: true
+  git:
+    enabled: true
+    worktree: true
+    auto-commit: true
+    branch-prefix: "agentic"
+
+variables:
+  - name: task
+    type: string
+    required: true
+    description: Task description or prompt
+  - name: create_pr
+    type: boolean
+    required: false
+    default: false
+    description: Whether to create a PR
+
+steps:
+  - name: create-branch
+    type: prompt
+    model: haiku
+    prompt: /af-git-branch {{ variables.type }} {{ variables.task }}
+
+  - name: execute-task
+    type: prompt
+    prompt: |
+      Complete the following task:
+
+      {{ variables.task }}
+
+      Guidelines:
+      - Analyze the codebase to understand context
+      - Make necessary changes following project conventions
+      - Use /af-git-commit to commit changes
+
+  - name: review
+    type: prompt
+    prompt: /af-sdlc-review "" major
+
+  - name: create-pr
+    type: conditional
+    condition: "variables.create_pr"
+    then:
+      - name: open-pr
+        type: prompt
+        prompt: /af-git-pr

package/src/workflows/plan-build-review.yaml

@@ -0,0 +1,160 @@
+name: plan-build-review
+version: "1.0"
+description: Full SDLC workflow with planning, implementation, and review
+
+settings:
+  max-retry: 3
+  timeout-minutes: 180
+  terminal-output: base
+  track-progress: true
+  git:
+    enabled: true
+    worktree: true
+    auto-commit: true
+    branch-prefix: "feature"
+
+variables:
+  - name: task
+    type: string
+    required: true
+    description: Feature/task description
+  - name: type
+    type: string
+    required: false
+    default: "auto"
+    description: Task type (feature, bug, chore, auto)
+  - name: fix_severity
+    type: string
+    required: false
+    default: "major"
+    description: Minimum severity for auto-fix
+  - name: explore_agents
+    type: integer
+    required: false
+    default: 2
+    description: Number of explore agents for codebase analysis (0=quick main session, 1+=parallel agents)
+  - name: max_iterations
+    type: number
+    required: false
+    default: 25
+    description: Maximum iterations for implementation and review fixes loops
+  - name: create_pr
+    type: boolean
+    required: false
+    default: false
+    description: Whether to create a PR
+
+steps:
+  - name: plan
+    type: prompt
+    model: opus
+    prompt: /af-sdlc-plan {{ workflow_id }} {{ variables.type }} "agentic/outputs/{{ workflow_id }}" {{ variables.explore_agents }} {{ variables.task }}
+    checkpoint: true
+
+  - name: create-branch
+    type: prompt
+    model: haiku
+    prompt: /af-git-branch {{ variables.type }} {{ variables.task }}
+
+  - name: implement
+    type: ralph-loop
+    prompt: |
+      ## Implementation Loop - Iteration {{iteration}}/{{max_iterations}}
+
+      You are in an iterative implementation loop. Each iteration starts a fresh session.
+
+      ## Your Task This Iteration
+      Read the plan at agentic/outputs/{{ workflow_id }}/plan.md and implement the NEXT INCOMPLETE milestone.
+
+      ## How Iterations Work
+      - Each iteration is a FRESH SESSION - you have no memory of previous iterations
+      - Work on exactly ONE milestone per iteration, then STOP
+      - The loop automatically starts a new iteration after you stop
+      - You do NOT need to output anything special to end an iteration - just stop working
+
+      ## Instructions for This Iteration
+      1. Read the plan file to find the next incomplete milestone
+      2. Implement all tasks within that single milestone
+      3. Run tests to verify your changes
+      4. Mark the milestone as complete in the plan file
+      5. Use /af-git-commit to commit your changes (including the plan.md if not gitignored)
+      6. STOP - do not continue to the next milestone
+
+      ## Completion Signal
+      When ALL milestones are marked complete in the plan, output:
+      ```json
+      {"ralph_complete": true, "promise": "ALL_MILESTONES_COMPLETE"}
+      ```
+
+      **IMPORTANT**:
+      - Only output the completion JSON when ALL milestones are genuinely finished and every validation completed successfully
+      - Complete ONE milestone per iteration, then STOP
+      - Do NOT try to implement multiple milestones in a single iteration
+    max-iterations: "{{ variables.max_iterations }}"
+    completion-promise: "ALL_MILESTONES_COMPLETE"
+    checkpoint: true
+
+  - name: review
+    type: prompt
+    prompt: /af-sdlc-review {{ workflow_id }} "agentic/outputs/{{ workflow_id }}/plan.md" "agentic/outputs/{{ workflow_id }}" minor
+    agent: agents/reviewer.md
+
+  - name: fix-issues
+    type: prompt
+    prompt: |
+      ## Fix Review Issues
+
+      Read both documents from the workflow output directory:
+      - Plan: `agentic/outputs/{{ workflow_id }}/plan.md`
+      - Review: `agentic/outputs/{{ workflow_id }}/review.md`
+
+      ### Task
+
+      1. **Parse the review.md** to identify all issues from the Issues table
+      2. **Filter by severity**: Only consider issues with severity `{{ variables.fix_severity }}` or higher
+         - Severity order: minor < major < critical
+      3. **If no issues** at or above `{{ variables.fix_severity }}` severity exist:
+         - Output success and end the session
+         - Return: `{"success": true, "issues_fixed": 0, "issues_remaining": 0}`
+      4. **If issues exist**, attempt to fix each one:
+         - For each issue, make the necessary code changes
+         - Run relevant checks (tests, lint, types, build) to verify the fix
+         - Track which issues were fixed and which could not be fixed
+      5. **After attempting fixes**:
+         - Use /af-git-commit to commit all fixes
+         - Re-run /af-sdlc-review {{ workflow_id }} "agentic/outputs/{{ workflow_id }}/plan.md" to update the Review section
+
+      ### Critical Requirement
+
+      After fixing, if ANY `major` or `critical` issues remain unfixed, you MUST:
+      - Output an error indicating which issues could not be fixed
+      - Return: `{"success": false, "error": "Unfixable issues remain", "issues_remaining": [...]}`
+
+      This will prevent the workflow from proceeding to the PR step.
+
+      ### Output
+
+      Return JSON with fix results:
+      ```json
+      {
+        "success": [true|false],
+        "issues_fixed": [count],
+        "issues_remaining": [count],
+        "unfixed_issues": ["issue1", "issue2"],
+        "error": "[error_message_if_failed]"
+      }
+      ```
+
+  - name: create-pr
+    type: conditional
+    condition: "variables.create_pr"
+    then:
+      - name: open-pr
+        type: prompt
+        prompt: /af-git-pr "{{ outputs.plan.summary }}"
+
+outputs:
+  - name: implementation-report
+    template: implementation-report.md.j2
+    path: report.md
+    when: completed