fix: refine

Author: cdcabrera

.gitignore

@@ -63,3 +63,4 @@ coverage/
 .agent
 reports/
 .output.txt
+poc/

guidelines/README.md

@@ -19,7 +19,7 @@ Agent-specific guidelines for the PatternFly MCP project, optimized for machine
 ### Skills
 
 - [Add docs links](./skills/add-docs-links/SKILL.md) - Add documentation links to `src/docs.json` in a structured way (format, duplicate check, URL confirmation, tests)
-- [Review Zod integration](./skills/review-zod-integration/SKILL.md) - Review Zod dependency bumps, map release notes to PF MCP, run tests, write `reports/YYYYMMDD-zod-{semver}-update-report.md`
+- [Review Zod integration](./skills/review-zod-integration/SKILL.md) - Review Zod dependency bumps, map release notes to PF MCP, run tests, write `reports/YYYYMMDD-HHMMSS-zod-{semver}-update-report.md` (UTC)
 
 **Note:** `guidelines/skills/` is the canonical location for skills. Repo symlinks point here so agents can discover them: `.agents/skills` (Cursor), `.claude/skills` (Claude). The `.agent/` directory (no “s”) is reserved for each developer’s local work and is off limits—do not use it for shared skills or guidelines.
 
@@ -37,7 +37,7 @@ Agents should use these phrases as signals to consult specific documentation and
 | **"review development guide"**      | Review `docs/development.md` for CLI, API, and plugin authoring.                                                                                       |
 | **"create an example tool plugin"** | Review `guidelines/agent_coding.md`, `docs/development.md`, `docs/examples/*`, and `src/*` for context, coding standards, and existing example formats. |
 | **"add documentation links"** / **"add doc entries"** / **"register docs"** / **"update docs.json"** / **"contribute to docs.json"** | Follow `guidelines/skills/add-docs-links/SKILL.md`: docs.json format, duplicate check, raw URL confirmation, then run unit tests and update meta. |
-| **"review zod"** / **"zod upgrade"** / **"zod integration review"** / **"zod update report"** | Follow `guidelines/skills/review-zod-integration/SKILL.md`: release notes vs codebase, tests, report at `reports/YYYYMMDD-zod-{semver}-update-report.md`. |
+| **"review zod"** / **"zod upgrade"** / **"zod integration review"** / **"zod update report"** | Follow `guidelines/skills/review-zod-integration/SKILL.md`: release notes vs codebase, tests, report at `reports/YYYYMMDD-HHMMSS-zod-{semver}-update-report.md` (UTC). |
 | **"troubleshoot server"** / **"debug server"** | Review `docs/usage.md#troubleshooting` and the PatternFly MCP server resource `patternfly://context` |
 
 ## Guidelines Processing Order

guidelines/skills/review-zod-integration/SKILL.md

@@ -52,7 +52,7 @@ description: Reviews Zod dependency upgrades for PatternFly MCP—maps release n
 
 6. **Write the report**
    - **Directory:** `reports/` at repository root (gitignored). Run `mkdir -p reports` if needed; do not delete prior reports.
-   - **Filename:** `YYYYMMDD-zod-{semver}-update-report.md` (`YYYYMMDD` = report date; `{semver}` = target version without `v`, e.g. `reports/20260521-zod-4.4.3-update-report.md`).
+   - **Filename:** `YYYYMMDD-HHMMSS-zod-{semver}-update-report.md` (`YYYYMMDD-HHMMSS` = report timestamp in **UTC**, 24-hour, no separators in the time part; `{semver}` = target version without `v`, e.g. `reports/20260522-143045-zod-4.4.3-update-report.md`).
    - Use [reference.md — Report template](reference.md#report-template). Do not commit unless the user asks.
 
 7. **User summary**
@@ -69,5 +69,5 @@ Domain context (SDK routing, schema pipeline, peer range): [reference.md — Qui
 - [ ] Every release-note bullet mapped with priority
 - [ ] Recurring P2s in report consolidated fixes
 - [ ] `test:types`, unit, `test:integration`, `test:audit` recorded
-- [ ] Report at `reports/YYYYMMDD-zod-{semver}-update-report.md`
+- [ ] Report at `reports/YYYYMMDD-HHMMSS-zod-{semver}-update-report.md` (UTC)
 - [ ] User asked before any P1/P2 code changes

guidelines/skills/review-zod-integration/reference.md

@@ -80,7 +80,7 @@ If release notes only mention these, impact is usually **None**:
 
 ## Report template
 
-Save as: **`reports/YYYYMMDD-zod-{semver}-update-report.md`** (e.g. `reports/20260521-zod-4.4.3-update-report.md`). The `reports/` directory is gitignored; ensure an allowance for an existing directory is made (e.g., `mkdir -p`) to preserve previous contents.
+Save as: **`reports/YYYYMMDD-HHMMSS-zod-{semver}-update-report.md`** (`YYYYMMDD-HHMMSS` = UTC timestamp when the report is written; e.g. `reports/20260522-143045-zod-4.4.3-update-report.md`). The `reports/` directory is gitignored; ensure an allowance for an existing directory is made (e.g., `mkdir -p`) to preserve previous contents.
 
 ```markdown
 # Zod {version} Update Report — PatternFly MCP