Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
23 changes: 18 additions & 5 deletions .cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@
"dependency-pinning-artifacts/**",
"evals/results/**",
"vally-results/**",
"evals/agent-behavior/eval.yaml"
"evals/agent-behavior/eval.yaml",
"plugins/**"
],
"ignoreRegExpList": [
"/#.*/g",
Expand Down Expand Up @@ -70,9 +71,14 @@
"general-technical"
],
"words": [
"ˈpræksɪs",
"accDescr",
"accTitle",
"activedescendant",
"agentic",
"aoda",
"approv",
"approximat",
"ASEC",
"atheris",
"ation",
Expand All @@ -96,10 +102,12 @@
"collab",
"consolidat",
"cosign",
"creat",
"cursored",
"dataclass",
"deeplink",
"deltatocumulative",
"Descr",
"desirab",
"dogfooding",
"domcontentloaded",
Expand All @@ -124,6 +132,7 @@
"hypothes",
"idor",
"IIBA",
"improvis",
"Infima",
"ISTQB",
"langchain",
Expand Down Expand Up @@ -159,7 +168,13 @@
"pylint",
"reakit",
"refus",
"remov",
"replac",
"reproduc",
"resolv",
"retriev",
"revalidat",
"sanitiz",
"scal",
"scorecard",
"Sigstore",
Expand All @@ -168,7 +183,6 @@
"smol",
"SPOF",
"SSSC",
"sssc",
"stdlib",
"stim",
"stimul",
Expand All @@ -183,8 +197,8 @@
"underspecified",
"unremediated",
"unsuffixed",
"vally",
"validat",
"vally",
"viab",
"violen",
"vulnerab",
Expand All @@ -196,8 +210,7 @@
"workiq",
"WSJF",
"ystatement",
"πρᾶξις",
"ˈpræksɪs"
"πρᾶξις"
],
"reporters": [
"default",
Expand Down
65 changes: 13 additions & 52 deletions .github/CUSTOM-AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,6 @@ Use the self-contained `rpi-challenger` skill to interrogate a confirmed subject
| **documentation** | Documentation audit, drift, authoring, and validation workflow | Uses the shared documentation skill and escalates formal assessments to planner agents |
| **meeting-analyst** | Analyzes meeting transcripts to extract product requirements via work-iq-mcp | Experimental; requires work-iq-mcp EULA; transcripts may contain PII and confidential data, analysis files are unencrypted on disk |
| **prd-builder** | Creates Product Requirements Documents through guided Q&A | Iterative questioning; state-tracked sessions |
| **product-manager-advisor** | Requirements discovery, story quality, and prioritization guidance | Principles over format; delegates to prd/brd builders |
| **security-planner** | STRIDE-based security model analysis with standards mapping and backlog handoff | Six-phase conversational workflow; experimental |
| **sssc-planner** | Supply chain security assessment with 6-phase workflow against OpenSSF Scorecard, SLSA, Sigstore, and SBOM | Six-phase conversational workflow; experimental |
| **rai-planner** | Responsible AI assessment with 6-phase workflow against Microsoft Responsible AI Impact Assessment Guide and NIST AI RMF | Six-phase conversational workflow; experimental |
Expand Down Expand Up @@ -87,12 +86,10 @@ to `hve-builder`; they are not independent agents or lifecycle owners.

### Platform Integration Agents

| Agent | Purpose | Key Constraint |
|----------------------------|----------------------------------------------------------------------------------|-------------------------------------------|
| **github-backlog-manager** | Consolidated GitHub backlog management with community interaction | Uses MCP GitHub tools |
| **jira-backlog-manager** | Consolidated Jira backlog management with workflow dispatch and handoff tracking | Uses Jira skill planning workflows |
| **ado-prd-to-wit** | Analyzes PRDs and plans Azure DevOps work item hierarchies | Planning-only; does not create work items |
| **jira-prd-to-wit** | Analyzes PRDs and plans Jira issue hierarchies | Planning-only; does not mutate Jira |
| Agent | Purpose | Key Constraint |
|------------------------|-----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| **backlog-manager** | Unified backlog and work management for Azure DevOps, GitHub, and Jira, plus ADO PR/build/sprint | Uses per-platform MCP tools and the Jira CLI; per-platform preflight |
| **functional-planner** | Analyzes PRDs and plans Azure DevOps or Jira work-item hierarchies with selectable framework lenses | Planning-only; never mutates a tracker |

### Testing Agents

Expand Down Expand Up @@ -124,16 +121,6 @@ to `hve-builder`; they are not independent agents or lifecycle owners.

**Critical:** `RPI Agent` is a user-selected lifecycle wrapper, not an autonomous loop or a dispatcher for named specialized task workers. It may use generic bounded delegation only when it materially improves an isolated activity. Navigate durable artifacts with the task ID, `Pxx`, `Pxx-Txx`, headings, and `<!-- rpi:... -->` markers.

### product-manager-advisor

**Purpose:** Requirements discovery, story quality assurance, and prioritization guidance.

**Workflow:** Discovery → Story Quality → Prioritization → Validation → Handoff

**Handoffs:** Delegates to `prd-builder` for full PRDs, `brd-builder` for business requirements, `ux-ui-designer` for journey mapping, and activates `rpi-research` for decision-critical research.

**Critical:** Focuses on quality principles rather than prescribing issue formats. Guides teams to leverage platform-native templates (GitHub issue forms, Azure DevOps work item templates). Differentiates from `prd-builder` by focusing on the requirements discovery gate rather than document authoring.

### ux-ui-designer

**Purpose:** UX research artifacts including Jobs-to-be-Done analysis, user journey mapping, and accessibility requirements.
Expand All @@ -145,7 +132,7 @@ to `hve-builder`; they are not independent agents or lifecycle owners.
* Accessibility requirements integrated into journey stages
* Design handoff sections with flow descriptions and principles

**Handoffs:** Delegates to `product-manager-advisor` for business alignment and activates `rpi-research` for technical feasibility research.
**Handoffs:** Delegates to `prd-builder` for formal product requirements, `backlog-plan` for tracked work items, and activates `rpi-research` for technical feasibility research.

**Critical:** Research-only. Does not generate UI designs or visual mockups. Produces artifacts that designers translate into Figma flows. Treats accessibility as a foundational constraint.

Expand Down Expand Up @@ -335,47 +322,21 @@ It dispatches thin perspective subagents under `.github/agents/coding-standards/

**Critical:** Produces machine-readable profiles for downstream consumption. Follows strict JSON schemas. Minimal clarifying questions.

### github-backlog-manager

**Creates:** Backlog management artifacts under `.copilot-tracking/github-issues/`

**Workflow:** Issue Creation | Backlog Discovery | Triage | Community Interaction

**Critical:** Uses MCP GitHub tools. Follows community interaction guidelines from `community-interaction.instructions.md` for all contributor-facing comments.

### jira-backlog-manager

**Creates:** Backlog management artifacts under `.copilot-tracking/jira-issues/`

**Workflow:** Intent Classification → Workflow Dispatch → Summary and Handoff

**Critical:** Uses the Jira skill command surface. Supports discovery, triage, execution, and single-issue workflows while preserving planning files and autonomy gates.

### ado-prd-to-wit

**Creates:** Work item planning files:

* `.copilot-tracking/workitems/prds/<artifact-normalized-name>/planning-log.md` (session activity and decisions)
* `.copilot-tracking/workitems/prds/<artifact-normalized-name>/artifact-analysis.md` (PRD parsing and extraction)
* `.copilot-tracking/workitems/prds/<artifact-normalized-name>/work-items.md` (Epic/Feature/Story hierarchy)
* `.copilot-tracking/workitems/prds/<artifact-normalized-name>/handoff.md` (final handoff for ADO creation)
### backlog-manager

**Workflow:** Analyze PRD → Discover Codebase → Discover Related Work Items → Refine → Finalize Handoff
**Creates:** Backlog management artifacts under `.copilot-tracking/{workitems,github-issues,jira-issues}/`

**Critical:** Planning-only. Uses ADO MCP tools for work item discovery. Supports Epics, Features, and User Stories.
**Workflow:** Platform and Intent Classification → Workflow Dispatch → Summary and Handoff

### jira-prd-to-wit
**Critical:** Unified across Azure DevOps, GitHub, and Jira. Resolves the target platform and runs a per-platform tool/credential preflight, delegates knowledge to the `backlog-management` skill, folds in ADO PR creation, build/pipeline info (and GitHub Actions), sprint, and task planning, routes PRD planning to the functional planner, and applies GitHub community-interaction guardrails for contributor-facing comments.

**Creates:** Work item planning files:
### functional-planner

* `.copilot-tracking/jira-issues/prds/<artifact-normalized-name>/planning-log.md` (session activity and decisions)
* `.copilot-tracking/jira-issues/prds/<artifact-normalized-name>/artifact-analysis.md` (PRD parsing and extraction)
* `.copilot-tracking/jira-issues/prds/<artifact-normalized-name>/issues-plan.md` (planned Jira issue hierarchy and field mappings)
* `.copilot-tracking/jira-issues/prds/<artifact-normalized-name>/handoff.md` (final handoff for Jira execution)
**Creates:** Work item planning files under `.copilot-tracking/{workitems,jira-issues}/prds/<artifact-normalized-name>/` (planning-log.md, artifact-analysis.md, the platform plan file, handoff.md)

**Workflow:** Analyze PRD → Discover Codebase → Discover Related Jira Issues → Refine → Finalize Handoff
**Workflow:** Analyze PRD → Discover Codebase → Discover Related Work Items → Refine Hierarchy → Finalize Handoff

**Critical:** Planning-only. Validates Jira issue types and required fields before finalizing plans. Does not call Jira mutation commands.
**Critical:** Strictly planning-only; never mutates a tracker. Consumes the `functional-planner` skill for the read-only PRD model, per-platform hierarchy rules (ADO Epic/Feature/Story; Jira Epic/Story/Task/Sub-task), and selectable open framework lenses (generic, Scrum, Kanban). Hands off to the `backlog-manager` for execution after user review.

### test-streamlit-dashboard

Expand Down
Loading
Loading