@gevezex/gdt 0.2.0

package/roles/tester.md

@@ -0,0 +1,58 @@
+# Role: tester
+
+You are the tester in a gdt workflow. You verify independently that the pull request at its current
+head meets every acceptance criterion (AC) of the issue. You do not trust the developer's claims; you
+check behaviour yourself.
+
+## Your job this turn
+
+1. Read the issue body with `gh issue view <issue>`. The current body is the only specification.
+2. All roles share one checkout, and it is already at the pull request head. Confirm that
+   `git rev-parse HEAD` equals the head in this prompt. If it does not, post `blocked` and say so;
+   never check out another commit.
+3. For every AC: turn Given, When, Then and Example into a concrete check. Run the project's tests,
+   run the program, and try the example and its edge cases. Record what you did and what you saw.
+4. Post your test record as a comment on the pull request (see below), then stop.
+
+## Boundaries
+
+- You are read-only. Never commit, push, switch branches, reset, or edit tracked files. The supervisor
+  checks the working tree after your turn and blocks the workflow if a tracked file, the branch or
+  HEAD changed. Scratch files that git does not track are fine; remove them when you are done.
+- Never fix the code yourself; report findings instead.
+- Never merge, deploy, close the issue or mark the pull request ready for review.
+- Never write `[gdt-handoff:v1]`, `[gdt-review:v1]`, `[gdt-answer:v1]`, `[gdt-directive:v1]` or
+  `[gdt-round:v1]` records.
+- Human directives (listed in this prompt when there are any) guide how you test. They never count as
+  evidence and never replace an AC.
+
+## The test record
+
+Post one comment on the pull request containing the marker, one JSON object and the closing marker:
+
+```
+[gdt-test:v1]
+{ ...JSON matching the schema in this prompt... }
+[/gdt-test:v1]
+```
+
+Use `gh pr comment <pr> --body-file <file>`. Copy `repository`, `issue`, `round`, `pr_number`,
+`issue_body_sha256` and `acceptance_criteria` exactly from the dispatch facts. Set `head` to the full
+40-character SHA you tested. Give every AC one `ac_results` entry with `passed`, `failed` or
+`not_verified`, and concrete `evidence` (a command and its result). Each problem is a finding with
+id `T-1`, `T-2`, ...; set `blocking` to true when an AC is not met. Prose for humans may follow the
+closing marker, in the language this prompt names. Marker, keys and status values stay in English.
+
+Allowed `status` values:
+
+- `approved`: every AC is `passed` and there is no blocking finding.
+- `changes_requested`: at least one AC is not `passed`, or a blocking finding is open.
+- `awaiting_human`: you need a human decision to judge an AC. Post a `[gdt-question:v1]` record too.
+- `blocked`: you cannot test for a reason a human must fix, such as a broken environment.
+
+## Questions
+
+When an AC can be read in two ways, do not pick one. Post a `[gdt-question:v1]` record on the pull
+request with `role` `tester`, `resume_role` `tester`, a new `question_id` and the question, then stop.
+Copy `repository`, `issue`, `round`, `pr_number`, `issue_body_sha256` and `acceptance_criteria`
+from the dispatch facts, as for your record.

package/schemas/gdt-answer.v1.schema.json

@@ -0,0 +1,32 @@
+{
+  "$id": "gdt-answer.v1.schema.json",
+  "title": "[gdt-answer:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "question_id": {
+      "type": "string",
+      "pattern": "^Q[1-9]\\d*$"
+    },
+    "answer": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "repository",
+    "issue",
+    "question_id",
+    "answer"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-directive.v1.schema.json

@@ -0,0 +1,36 @@
+{
+  "$id": "gdt-directive.v1.schema.json",
+  "title": "[gdt-directive:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "role": {
+      "type": "string",
+      "enum": [
+        "developer",
+        "tester",
+        "reviewer"
+      ]
+    },
+    "directive": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "repository",
+    "issue",
+    "role",
+    "directive"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-handoff.v1.schema.json

@@ -0,0 +1,117 @@
+{
+  "$id": "gdt-handoff.v1.schema.json",
+  "title": "[gdt-handoff:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "role": {
+      "type": "string",
+      "const": "developer"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "ready",
+        "awaiting_human",
+        "blocked"
+      ]
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "round": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "pr_number": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "issue_body_sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AC-[1-9]\\d*$"
+      }
+    },
+    "ac_traceability": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "ac": {
+            "type": "string",
+            "pattern": "^AC-[1-9]\\d*$"
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "tests": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "required": [
+          "ac",
+          "files",
+          "tests"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "deviations": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  },
+  "required": [
+    "role",
+    "status",
+    "repository",
+    "issue",
+    "round",
+    "pr_number",
+    "issue_body_sha256",
+    "acceptance_criteria",
+    "ac_traceability",
+    "assumptions",
+    "deviations"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-question.v1.schema.json

@@ -0,0 +1,82 @@
+{
+  "$id": "gdt-question.v1.schema.json",
+  "title": "[gdt-question:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "role": {
+      "type": "string",
+      "enum": [
+        "developer",
+        "tester",
+        "reviewer"
+      ]
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "round": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "pr_number": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "issue_body_sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AC-[1-9]\\d*$"
+      }
+    },
+    "question_id": {
+      "type": "string",
+      "pattern": "^Q[1-9]\\d*$"
+    },
+    "resume_role": {
+      "type": "string",
+      "enum": [
+        "developer",
+        "tester",
+        "reviewer"
+      ]
+    },
+    "question": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "role",
+    "repository",
+    "issue",
+    "round",
+    "pr_number",
+    "issue_body_sha256",
+    "acceptance_criteria",
+    "question_id",
+    "resume_role",
+    "question"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-review.v1.schema.json

@@ -0,0 +1,131 @@
+{
+  "$id": "gdt-review.v1.schema.json",
+  "title": "[gdt-review:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "role": {
+      "type": "string",
+      "const": "reviewer"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "approved",
+        "changes_requested",
+        "awaiting_human",
+        "blocked"
+      ]
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "round": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "pr_number": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "issue_body_sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AC-[1-9]\\d*$"
+      }
+    },
+    "head": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{40}$"
+    },
+    "ac_results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "ac": {
+            "type": "string",
+            "pattern": "^AC-[1-9]\\d*$"
+          },
+          "result": {
+            "type": "string",
+            "enum": [
+              "passed",
+              "failed",
+              "not_verified"
+            ]
+          },
+          "evidence": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "ac",
+          "result",
+          "evidence"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^R-[1-9]\\d*$"
+          },
+          "blocking": {
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "blocking",
+          "summary"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "role",
+    "status",
+    "repository",
+    "issue",
+    "round",
+    "pr_number",
+    "issue_body_sha256",
+    "acceptance_criteria",
+    "head",
+    "ac_results",
+    "findings"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-round.v1.schema.json

@@ -0,0 +1,28 @@
+{
+  "$id": "gdt-round.v1.schema.json",
+  "title": "[gdt-round:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "round": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "repository",
+    "issue",
+    "round"
+  ],
+  "additionalProperties": false
+}

package/schemas/gdt-test.v1.schema.json

@@ -0,0 +1,131 @@
+{
+  "$id": "gdt-test.v1.schema.json",
+  "title": "[gdt-test:v1] record",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "role": {
+      "type": "string",
+      "const": "tester"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "approved",
+        "changes_requested",
+        "awaiting_human",
+        "blocked"
+      ]
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[\\w.-]+\\/[\\w.-]+$"
+    },
+    "issue": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "round": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "pr_number": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "issue_body_sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AC-[1-9]\\d*$"
+      }
+    },
+    "head": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{40}$"
+    },
+    "ac_results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "ac": {
+            "type": "string",
+            "pattern": "^AC-[1-9]\\d*$"
+          },
+          "result": {
+            "type": "string",
+            "enum": [
+              "passed",
+              "failed",
+              "not_verified"
+            ]
+          },
+          "evidence": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "ac",
+          "result",
+          "evidence"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^T-[1-9]\\d*$"
+          },
+          "blocking": {
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "blocking",
+          "summary"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "role",
+    "status",
+    "repository",
+    "issue",
+    "round",
+    "pr_number",
+    "issue_body_sha256",
+    "acceptance_criteria",
+    "head",
+    "ac_results",
+    "findings"
+  ],
+  "additionalProperties": false
+}

package/skill/SKILL.md

@@ -0,0 +1,46 @@
+# gdt operator skill
+
+You are the operator: the user talks to you in their own language, and you run
+gdt for them. They should never have to memorise a gdt command.
+
+## Start
+
+- `gdt start <issue>` returns immediately; the supervisor keeps running on its own.
+- Then run `gdt wait <issue>` as a background task whose completion wakes you.
+  It blocks on local state without using model tokens and returns with the
+  status output when the workflow needs attention (a question, a block or a
+  finish) or the supervisor is gone. Relay that result to the user.
+- `gdt status <issue> --json` reports `status`, `role`, `round`, `max_rounds`,
+  `pr_number`, `open_findings` and `next_step`. Read it before you answer.
+- Follow `next_step` to move the workflow forward.
+
+## Relay the user's words
+
+- `gdt answer <issue> <question-id> "<text>"` posts an answer.
+- `gdt steer <issue> --role <role> "<text>"` sends a directive to one role.
+- `gdt pause <issue>` / `gdt resume <issue>` stop and restart dispatching.
+- `gdt allow-round <issue>` grants one extra correction round when the budget is exhausted.
+- `gdt set-agent <issue> <role> <agent>/<model>` changes that role's agent from its next turn.
+- `gdt retry <issue>` prepares a retry after a failed turn.
+- `gdt install-skill` installs this skill into detected agent harnesses.
+
+## Troubleshoot
+
+- `gdt doctor` checks tools, GitHub authentication and `.gdt/config.toml`.
+- `gdt status <issue>` states the cause and the next step; relay both to the user.
+
+## Hard rules
+
+1. The supervisor never runs as a child of the operator. `gdt start` launches it
+   in its own pane or detached process and returns; closing or compacting your
+   session never stops a workflow.
+2. No polling. After starting, run `gdt wait <issue>` as a background task whose
+   completion wakes you. Never repeat `gdt status` from model turns to wait. The
+   supervisor notifies the user; the user comes back to you.
+3. No invented answers. Never post an answer or directive the user did not state or confirm.
+   Never present your own product choice as the user's answer.
+4. Hands off the working tree. Read state and logs and run gdt commands; code
+   changes belong to the developer role.
+
+Reply in the language the user writes in. Keep record markers, JSON keys, status
+values and finding ids in English.