Skip to content

Commit ec0a041

Browse files
committed
Use {AI_WORKFLOWS_ROOT} pattern for script paths in report.md
Align with the convention established in PR #79 and _shared/recipes/capture-provenance-event.md: use {AI_WORKFLOWS_ROOT} instead of {triage_workflow_dir} or relative ../scripts/ paths. Also update the Report row in guidelines.md to reflect that the phase now runs render_report.py and writes ai-synthesis.json. Assisted-by: Claude Opus 4.6 (1M) <noreply@anthropic.com>
1 parent f84da69 commit ec0a041

2 files changed

Lines changed: 12 additions & 12 deletions

File tree

‎triage/guidelines.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Artifacts go in `.artifacts/triage/{project}/`.
3939
| Start | `jira_search` | `mkdir` (create artifact dir) |
4040
| Scan | `jira_search` | Write `issues.json` and `resolved.json` |
4141
| Analyze | none | Read `issues.json`, read `resolved.json` (if present), write `analyzed.json` |
42-
| Report | none | Read `analyzed.json`, read `templates/report.html`, write `report.html` |
42+
| Report | none | Read `analyzed.json`, read `issues.json` (for Jira URL); run `scripts/render_report.py`; write `ai-synthesis.json`, `report.html` |
4343
| Assess (`/assess`) | `jira_search` | Optionally read `issues.json`; no required artifact writes |
4444

4545
Any tool not listed above is **prohibited** in that phase. If a phase needs data not available through its allowed tools, stop and ask the user.

‎triage/skills/report.md‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: Generate a self-contained interactive HTML report from analyzed tri
88
You are generating an interactive HTML report from the analyzed triage data. Your goal is to produce a **single HTML file** that can be opened in any browser — emailed or shared as-is with no additional data files. The template uses optional **Google Fonts** when online; offline, browsers fall back to system fonts. All CSS, JS, and issue data are inline or embedded.
99

1010
Template rendering (placeholder replacement, validation) is handled by
11-
`../scripts/render_report.py`. Your role is to locate the inputs,
11+
`triage/scripts/render_report.py`. Your role is to locate the inputs,
1212
synthesize the executive summary and release risk assessment, then invoke
1313
the script to produce the final HTML.
1414

@@ -147,24 +147,24 @@ Format:
147147
corresponding report section hides automatically — these are valid
148148
values, not errors.
149149

150-
Then run the rendering script (`../scripts/render_report.py` relative to
151-
this skill file). The script replaces all template placeholders, validates
152-
the output, and writes the final HTML file. Resolve the script and
153-
template paths relative to the triage workflow directory — the `--analyzed`,
154-
`--ai-input`, and `--output` paths are relative to the project root (CWD).
150+
Then run the rendering script (`triage/scripts/render_report.py`). The
151+
script replaces all template placeholders, validates the output, and
152+
writes the final HTML file.
153+
154+
Resolve `{AI_WORKFLOWS_ROOT}` as the git root of the ai-workflows
155+
install (see `_shared/recipes/capture-provenance-event.md` for the
156+
canonical resolution instructions). The `--analyzed`, `--ai-input`, and
157+
`--output` paths are relative to the project root (CWD).
155158

156159
```bash
157-
python3 {triage_workflow_dir}/scripts/render_report.py \
160+
python3 "{AI_WORKFLOWS_ROOT}/triage/scripts/render_report.py" \
158161
--analyzed .artifacts/triage/{PROJECT}/analyzed.json \
159-
--template {triage_workflow_dir}/templates/report.html \
162+
--template "{AI_WORKFLOWS_ROOT}/triage/templates/report.html" \
160163
--jira-url {JIRA_BASE_URL} \
161164
--ai-input .artifacts/triage/{PROJECT}/ai-synthesis.json \
162165
--output .artifacts/triage/{PROJECT}/report.html
163166
```
164167

165-
Where `{triage_workflow_dir}` is the triage workflow's installed location
166-
(e.g., resolve the `triage` symlink under the workflows install directory).
167-
168168
If the script exits with a non-zero code, report the error to the user:
169169
- Exit 1: a required input file is missing or contains invalid JSON
170170
- Exit 2: unreplaced placeholders remain in the output (indicates a

0 commit comments

Comments
 (0)