From e3eae9e9f65c96f0579b5a1d5d222ea081601a3b Mon Sep 17 00:00:00 2001 From: GermanM Date: Tue, 14 Apr 2026 20:06:37 +0300 Subject: [PATCH] Tighten MD3 stage-1 skill proof --- .../evidence.json | 30 ++++++++++-- .../evidence.md | 15 +++--- .../problems.md | 2 +- .../raw/audit-contract-check.txt | 29 ++++++------ .../raw/platform-boundaries-check.txt | 13 +++--- .../raw/plugin-sync-check.json | 40 ++++++++++++++++ .../raw/skill-file-check.txt | 34 ++++++-------- .../raw/skill-mode-check.txt | 46 +++++++++++-------- .../verdict.json | 6 +-- .agents/skills/material-3/SKILL.md | 9 ++++ plugin/skills/material-3/SKILL.md | 9 ++++ 11 files changed, 162 insertions(+), 71 deletions(-) create mode 100644 .agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json diff --git a/.agent/tasks/codex-material-3-stage-1-skill/evidence.json b/.agent/tasks/codex-material-3-stage-1-skill/evidence.json index e26d489..581f15d 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/evidence.json +++ b/.agent/tasks/codex-material-3-stage-1-skill/evidence.json @@ -3,14 +3,34 @@ "builder_identity": "task-builder", "commands": [ { - "cmd": "Get-ChildItem -Recurse .agents/skills/material-3", + "cmd": "Get-ChildItem -Recurse .agents\\skills\\material-3 | ForEach-Object { $_.FullName } | Set-Content -Encoding utf8 .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\skill-file-check.txt", "exit_code": 0, "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/skill-file-check.txt" }, { - "cmd": "python C:\\Users\\tikta\\.codex\\skills\\.system\\skill-creator\\scripts\\quick_validate.py .agents/skills/material-3", + "cmd": "rg -n \"component|theme|layout|scaffold|audit|decision path\" .agents/skills/material-3/SKILL.md | Set-Content -Encoding utf8 .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\skill-mode-check.txt", + "exit_code": 0, + "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt" + }, + { + "cmd": "rg -n \"Compose|Flutter|Web|compose|flutter|web|parity\" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/platform-matrix.md | Set-Content -Encoding utf8 .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\platform-boundaries-check.txt", + "exit_code": 0, + "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/platform-boundaries-check.txt" + }, + { + "cmd": "rg -n \"scorecard|findings|quick wins|remediation sequence|unresolved risks|Critical|High|Medium|Low|Note|smallest safe\" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/audit-rubric.md .agents/skills/material-3/references/remediation-policy.md | Set-Content -Encoding utf8 .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\audit-contract-check.txt", + "exit_code": 0, + "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/audit-contract-check.txt" + }, + { + "cmd": "python C:\\Users\\tikta\\.codex\\skills\\.system\\skill-creator\\scripts\\quick_validate.py .agents/skills/material-3 *> .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\quick-validate.txt", "exit_code": 0, "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/quick-validate.txt" + }, + { + "cmd": "python scripts/sync_plugin_bundle.py *> .agent\\tasks\\codex-material-3-stage-1-skill\\raw\\plugin-sync-check.json", + "exit_code": 0, + "artifact": ".agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json" } ], "artifacts": [ @@ -33,6 +53,10 @@ { "path": ".agent/tasks/codex-material-3-stage-1-skill/raw/quick-validate.txt", "type": "text" + }, + { + "path": ".agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json", + "type": "json" } ], "ac_map": { @@ -50,5 +74,5 @@ "tag": null, "release_commit_message": null }, - "timestamp": "2026-04-14T19:50:30+03:00" + "timestamp": "2026-04-14T20:04:05.2029772+03:00" } diff --git a/.agent/tasks/codex-material-3-stage-1-skill/evidence.md b/.agent/tasks/codex-material-3-stage-1-skill/evidence.md index c3adfee..1abe76c 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/evidence.md +++ b/.agent/tasks/codex-material-3-stage-1-skill/evidence.md @@ -1,14 +1,15 @@ # Evidence for codex-material-3-stage-1-skill ## Build summary -Created the canonical repo-local Material Design 3 skill under `.agents/skills/material-3/`, including the required reference corpus, UI metadata, and usage notes. The skill is explicitly MD3-specific and encodes component, theme, layout, scaffold, and audit modes. +Refined the canonical repo-local Material Design 3 skill under `.agents/skills/material-3/` by making the mode-selection decision path explicit in `SKILL.md` and tightening the Web-limited boundary without expanding beyond MD3 scope. Re-synchronized the bundled plugin copy through the packaging path, then rebuilt the stage-1 evidence from fresh repo-local checks. ## Commands run -- `Get-ChildItem -Recurse .agents/skills/material-3` -- `rg -n "component|theme|layout|scaffold|audit" .agents/skills/material-3/SKILL.md` -- `rg -n "Compose|Flutter|Web|compose|flutter|web" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/platform-matrix.md` -- `rg -n "scorecard|findings|quick wins|remediation sequence|unresolved risks|Critical|High|Medium|Low|Note" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/audit-rubric.md .agents/skills/material-3/references/remediation-policy.md` -- `python C:\Users\tikta\.codex\skills\.system\skill-creator\scripts\quick_validate.py .agents/skills/material-3` +- `Get-ChildItem -Recurse .agents\skills\material-3 | ForEach-Object { $_.FullName } | Set-Content -Encoding utf8 .agent\tasks\codex-material-3-stage-1-skill\raw\skill-file-check.txt` +- `rg -n "component|theme|layout|scaffold|audit|decision path" .agents/skills/material-3/SKILL.md | Set-Content -Encoding utf8 .agent\tasks\codex-material-3-stage-1-skill\raw\skill-mode-check.txt` +- `rg -n "Compose|Flutter|Web|compose|flutter|web|parity" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/platform-matrix.md | Set-Content -Encoding utf8 .agent\tasks\codex-material-3-stage-1-skill\raw\platform-boundaries-check.txt` +- `rg -n "scorecard|findings|quick wins|remediation sequence|unresolved risks|Critical|High|Medium|Low|Note|smallest safe" .agents/skills/material-3/SKILL.md .agents/skills/material-3/references/audit-rubric.md .agents/skills/material-3/references/remediation-policy.md | Set-Content -Encoding utf8 .agent\tasks\codex-material-3-stage-1-skill\raw\audit-contract-check.txt` +- `python C:\Users\tikta\.codex\skills\.system\skill-creator\scripts\quick_validate.py .agents/skills/material-3 *> .agent\tasks\codex-material-3-stage-1-skill\raw\quick-validate.txt` +- `python scripts/sync_plugin_bundle.py *> .agent\tasks\codex-material-3-stage-1-skill\raw\plugin-sync-check.json` ## Raw artifacts - `raw/skill-file-check.txt` @@ -16,6 +17,7 @@ Created the canonical repo-local Material Design 3 skill under `.agents/skills/m - `raw/platform-boundaries-check.txt` - `raw/audit-contract-check.txt` - `raw/quick-validate.txt` +- `raw/plugin-sync-check.json` ## Acceptance criteria mapping - AC1.1 -> evidence: [SKILL.md](/C:/Develop/Projects/CodexMD3/.agents/skills/material-3/SKILL.md), `raw/quick-validate.txt` @@ -29,6 +31,7 @@ Created the canonical repo-local Material Design 3 skill under `.agents/skills/m ## Known limitations - The skill includes usage notes because the task explicitly required them, even though the generic skill-creator guidance would normally avoid extra docs. - Web support remains intentionally limited to token and guidance paths. +- Plugin sync proof is recorded to avoid bundle drift, but plugin packaging itself remains outside the stage-1 acceptance boundary. ## Release evidence - current version: `1.0.0` diff --git a/.agent/tasks/codex-material-3-stage-1-skill/problems.md b/.agent/tasks/codex-material-3-stage-1-skill/problems.md index 92ae929..531d556 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/problems.md +++ b/.agent/tasks/codex-material-3-stage-1-skill/problems.md @@ -1,3 +1,3 @@ # Problems for codex-material-3-stage-1-skill -No open problems at verification time. +Fresh verifier pass found no open problems. diff --git a/.agent/tasks/codex-material-3-stage-1-skill/raw/audit-contract-check.txt b/.agent/tasks/codex-material-3-stage-1-skill/raw/audit-contract-check.txt index b5f9fe7..572c31d 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/raw/audit-contract-check.txt +++ b/.agent/tasks/codex-material-3-stage-1-skill/raw/audit-contract-check.txt @@ -1,17 +1,20 @@ +.agents/skills/material-3/references/remediation-policy.md:5:Fix the smallest safe MD3 violation first. Use local, token-level, or component-level changes before considering layout rewrites. .agents/skills/material-3/references/remediation-policy.md:29:- marking findings as resolved without fresh verification -.agents/skills/material-3/SKILL.md:41:- `references/remediation-policy.md`: smallest safe MD3-correct fix policy. -.agents/skills/material-3/SKILL.md:78:- `scorecard` -.agents/skills/material-3/SKILL.md:79:- `findings` -.agents/skills/material-3/SKILL.md:80:- `quick wins` -.agents/skills/material-3/SKILL.md:81:- `remediation sequence` -.agents/skills/material-3/SKILL.md:82:- `unresolved risks` -.agents/skills/material-3/SKILL.md:97:- `Critical` -.agents/skills/material-3/SKILL.md:98:- `High` -.agents/skills/material-3/SKILL.md:99:- `Medium` -.agents/skills/material-3/SKILL.md:100:- `Low` -.agents/skills/material-3/SKILL.md:101:- `Note` -.agents/skills/material-3/SKILL.md:113:Use the optional MCP layer for deterministic lookups, theme scaffolds, scorecards, and release consistency checks. Keep these activities in the skill reasoning layer: -.agents/skills/material-3/SKILL.md:117:- prioritizing remediation sequence +.agents/skills/material-3/SKILL.md:26:- `audit`: Score an existing screen or code path for MD3 compliance and propose the smallest safe fixes. +.agents/skills/material-3/SKILL.md:50:- `references/remediation-policy.md`: smallest safe MD3-correct fix policy. +.agents/skills/material-3/SKILL.md:87:- `scorecard` +.agents/skills/material-3/SKILL.md:88:- `findings` +.agents/skills/material-3/SKILL.md:89:- `quick wins` +.agents/skills/material-3/SKILL.md:90:- `remediation sequence` +.agents/skills/material-3/SKILL.md:91:- `unresolved risks` +.agents/skills/material-3/SKILL.md:106:- `Critical` +.agents/skills/material-3/SKILL.md:107:- `High` +.agents/skills/material-3/SKILL.md:108:- `Medium` +.agents/skills/material-3/SKILL.md:109:- `Low` +.agents/skills/material-3/SKILL.md:110:- `Note` +.agents/skills/material-3/SKILL.md:117:- When proposing fixes, use the smallest safe change that restores MD3 correctness. +.agents/skills/material-3/SKILL.md:122:Use the optional MCP layer for deterministic lookups, theme scaffolds, scorecards, and release consistency checks. Keep these activities in the skill reasoning layer: +.agents/skills/material-3/SKILL.md:126:- prioritizing remediation sequence .agents/skills/material-3/references/audit-rubric.md:24:- quick wins .agents/skills/material-3/references/audit-rubric.md:25:- remediation sequence .agents/skills/material-3/references/audit-rubric.md:26:- unresolved risks diff --git a/.agent/tasks/codex-material-3-stage-1-skill/raw/platform-boundaries-check.txt b/.agent/tasks/codex-material-3-stage-1-skill/raw/platform-boundaries-check.txt index 8f79a40..769796f 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/raw/platform-boundaries-check.txt +++ b/.agent/tasks/codex-material-3-stage-1-skill/raw/platform-boundaries-check.txt @@ -1,9 +1,3 @@ -.agents/skills/material-3/SKILL.md:3:description: Design, scaffold, theme, adapt, and audit Material Design 3 / Material You user interfaces with a Compose-first workflow, Flutter-secondary implementation guidance, and limited Web token guidance. Use when Codex needs to choose or generate MD3 components, build or adapt MD3 themes, produce MD3 layout or navigation shells, scaffold MD3 screens, or run an MD3-specific compliance audit with concrete remediation. -.agents/skills/material-3/SKILL.md:12:- Prefer Jetpack Compose Material 3 APIs and patterns as the primary path. -.agents/skills/material-3/SKILL.md:13:- Support Flutter Material 3 as a secondary implementation path. -.agents/skills/material-3/SKILL.md:14:- Keep Web support limited to tokens, CSS architecture, and component guidance unless the user explicitly asks for a constrained web implementation. -.agents/skills/material-3/SKILL.md:40:- `references/platform-matrix.md`: Compose-first, Flutter-secondary, Web-limited boundaries. -.agents/skills/material-3/SKILL.md:124:- Do not invert platform priorities; Compose stays primary. .agents/skills/material-3/references/platform-matrix.md:5:- Jetpack Compose Material 3: primary path .agents/skills/material-3/references/platform-matrix.md:6:- Flutter Material 3: secondary path .agents/skills/material-3/references/platform-matrix.md:7:- Web design systems and CSS tokens: limited path @@ -15,3 +9,10 @@ .agents/skills/material-3/references/platform-matrix.md:28:## Web-limited rule .agents/skills/material-3/references/platform-matrix.md:30:Keep web support focused on: .agents/skills/material-3/references/platform-matrix.md:37:Do not present the web path as equal in coverage to Compose unless the implementation proves it. +.agents/skills/material-3/SKILL.md:3:description: Design, scaffold, theme, adapt, and audit Material Design 3 / Material You user interfaces with a Compose-first workflow, Flutter-secondary implementation guidance, and limited Web token guidance. Use when Codex needs to choose or generate MD3 components, build or adapt MD3 themes, produce MD3 layout or navigation shells, scaffold MD3 screens, or run an MD3-specific compliance audit with concrete remediation. +.agents/skills/material-3/SKILL.md:12:- Prefer Jetpack Compose Material 3 APIs and patterns as the primary path. +.agents/skills/material-3/SKILL.md:13:- Support Flutter Material 3 as a secondary implementation path. +.agents/skills/material-3/SKILL.md:14:- Keep Web support limited to tokens, CSS architecture, and component guidance unless the user explicitly asks for a constrained web implementation. +.agents/skills/material-3/SKILL.md:15:- Do not imply full Web parity with Compose unless the repo-local implementation proves it. +.agents/skills/material-3/SKILL.md:49:- `references/platform-matrix.md`: Compose-first, Flutter-secondary, Web-limited boundaries. +.agents/skills/material-3/SKILL.md:133:- Do not invert platform priorities; Compose stays primary. diff --git a/.agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json b/.agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json new file mode 100644 index 0000000..b9845d8 --- /dev/null +++ b/.agent/tasks/codex-material-3-stage-1-skill/raw/plugin-sync-check.json @@ -0,0 +1,40 @@ +{ + "source_exists": true, + "target_exists": true, + "matches": true, + "source_files": [ + "SKILL.md", + "USAGE.md", + "agents/openai.yaml", + "references/audit-rubric.md", + "references/color-system.md", + "references/component-catalog.md", + "references/layout-and-responsive.md", + "references/navigation-patterns.md", + "references/platform-matrix.md", + "references/release-readiness.md", + "references/remediation-policy.md", + "references/theming-and-dynamic-color.md", + "references/typography-and-shape.md" + ], + "target_files": [ + "SKILL.md", + "USAGE.md", + "agents/openai.yaml", + "references/audit-rubric.md", + "references/color-system.md", + "references/component-catalog.md", + "references/layout-and-responsive.md", + "references/navigation-patterns.md", + "references/platform-matrix.md", + "references/release-readiness.md", + "references/remediation-policy.md", + "references/theming-and-dynamic-color.md", + "references/typography-and-shape.md" + ], + "missing_in_target": [], + "extra_in_target": [], + "content_mismatches": [], + "mode": "sync", + "status": "PASS" +} diff --git a/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-file-check.txt b/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-file-check.txt index 9e67fbb..2246e50 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-file-check.txt +++ b/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-file-check.txt @@ -1,19 +1,15 @@ -Microsoft.PowerShell.Commands.Internal.Format.FormatStartData -Microsoft.PowerShell.Commands.Internal.Format.GroupStartData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.FormatEntryData -Microsoft.PowerShell.Commands.Internal.Format.GroupEndData -Microsoft.PowerShell.Commands.Internal.Format.FormatEndData +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\agents +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\SKILL.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\USAGE.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\agents\openai.yaml +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\audit-rubric.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\color-system.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\component-catalog.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\layout-and-responsive.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\navigation-patterns.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\platform-matrix.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\release-readiness.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\remediation-policy.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\theming-and-dynamic-color.md +C:\Develop\Projects\CodexMD3\.agents\skills\material-3\references\typography-and-shape.md diff --git a/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt b/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt index bdac14d..ee3d898 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt +++ b/.agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt @@ -1,22 +1,28 @@ 3:description: Design, scaffold, theme, adapt, and audit Material Design 3 / Material You user interfaces with a Compose-first workflow, Flutter-secondary implementation guidance, and limited Web token guidance. Use when Codex needs to choose or generate MD3 components, build or adapt MD3 themes, produce MD3 layout or navigation shells, scaffold MD3 screens, or run an MD3-specific compliance audit with concrete remediation. 14:- Keep Web support limited to tokens, CSS architecture, and component guidance unless the user explicitly asks for a constrained web implementation. -15:- Treat MD3 as personal, adaptive, and expressive: start from task intent, state, context, and device class before choosing components. -21:- `component`: Choose, adapt, or validate one or more MD3 components. -22:- `theme`: Generate or adjust MD3 theme tokens, tonal roles, dynamic color guidance, typography, shape, elevation, or contrast strategy. -23:- `layout`: Choose responsive layout rules, breakpoints, window size behavior, edge-to-edge handling, or adaptive navigation. -24:- `scaffold`: Assemble an app shell, screen skeleton, or navigation shell that follows MD3 structure. -25:- `audit`: Score an existing screen or code path for MD3 compliance and propose the smallest safe fixes. -27:If a request spans multiple areas, set a primary mode and a secondary mode. Example: a dashboard shell with theme polish is `scaffold` primary and `theme` secondary. -34:- `references/component-catalog.md`: canonical component selection and state requirements. -35:- `references/theming-and-dynamic-color.md`: seed color, dynamic color, dark theme guidance. -38:- `references/layout-and-responsive.md`: window size classes, insets, foldables, adaptive shells. -39:- `references/audit-rubric.md`: MD3 compliance categories, scoring, finding contract. -49:- Name the recommended MD3 component or composition. -56:- Produce role-level theme guidance: color roles, tonal surfaces, typography, shape, elevation, contrast, dark theme behavior. -57:- Separate deterministic token scaffolding from subjective visual tuning. -65:- Keep the layout shell MD3-compliant before tuning visual details. -105:- Audit against MD3 tokens, components, theming, layout, and navigation rules, not against personal taste. -109:- Do not recommend a rewrite when a token, component swap, state fix, or layout adjustment is enough. -113:Use the optional MCP layer for deterministic lookups, theme scaffolds, scorecards, and release consistency checks. Keep these activities in the skill reasoning layer: -115:- choosing the best component composition for ambiguous product intent -126:- Do not claim MD3 compliance without explicit evidence or an audit pass. +16:- Treat MD3 as personal, adaptive, and expressive: start from task intent, state, context, and device class before choosing components. +22:- `component`: Choose, adapt, or validate one or more MD3 components. +23:- `theme`: Generate or adjust MD3 theme tokens, tonal roles, dynamic color guidance, typography, shape, elevation, or contrast strategy. +24:- `layout`: Choose responsive layout rules, breakpoints, window size behavior, edge-to-edge handling, or adaptive navigation. +25:- `scaffold`: Assemble an app shell, screen skeleton, or navigation shell that follows MD3 structure. +26:- `audit`: Score an existing screen or code path for MD3 compliance and propose the smallest safe fixes. +28:If a request spans multiple areas, set a primary mode and a secondary mode. Example: a dashboard shell with theme polish is `scaffold` primary and `theme` secondary. +30:Use this decision path when the request is ambiguous: +32:- Existing screen, code path, or screenshot that needs scoring or gap analysis -> `audit` +33:- New app shell, screen skeleton, or navigation shell -> `scaffold` +34:- Window-size adaptation, navigation switching, insets, or responsive shell behavior -> `layout` +35:- Seed color, tokens, dynamic color, typography, shape, or elevation strategy -> `theme` +36:- Specific control, state model, or component choice -> `component` +43:- `references/component-catalog.md`: canonical component selection and state requirements. +44:- `references/theming-and-dynamic-color.md`: seed color, dynamic color, dark theme guidance. +47:- `references/layout-and-responsive.md`: window size classes, insets, foldables, adaptive shells. +48:- `references/audit-rubric.md`: MD3 compliance categories, scoring, finding contract. +58:- Name the recommended MD3 component or composition. +65:- Produce role-level theme guidance: color roles, tonal surfaces, typography, shape, elevation, contrast, dark theme behavior. +66:- Separate deterministic token scaffolding from subjective visual tuning. +74:- Keep the layout shell MD3-compliant before tuning visual details. +114:- Audit against MD3 tokens, components, theming, layout, and navigation rules, not against personal taste. +118:- Do not recommend a rewrite when a token, component swap, state fix, or layout adjustment is enough. +122:Use the optional MCP layer for deterministic lookups, theme scaffolds, scorecards, and release consistency checks. Keep these activities in the skill reasoning layer: +124:- choosing the best component composition for ambiguous product intent +135:- Do not claim MD3 compliance without explicit evidence or an audit pass. diff --git a/.agent/tasks/codex-material-3-stage-1-skill/verdict.json b/.agent/tasks/codex-material-3-stage-1-skill/verdict.json index a673b2a..8fbbb74 100644 --- a/.agent/tasks/codex-material-3-stage-1-skill/verdict.json +++ b/.agent/tasks/codex-material-3-stage-1-skill/verdict.json @@ -2,7 +2,7 @@ "task_id": "codex-material-3-stage-1-skill", "verifier_identity": "fresh-verifier", "verdict": "PASS", - "summary": "The canonical Material 3 skill is present, MD3-specific, mode-complete, and backed by the required reference corpus.", + "summary": "The canonical Material 3 skill is present, MD3-specific, mode-complete, now exposes an explicit mode decision path, and remains backed by the required reference corpus.", "acceptance_criteria": [ { "id": "AC1.1", @@ -16,7 +16,7 @@ { "id": "AC1.2", "status": "PASS", - "reason": "The skill defines the five required modes and provides a decision path for selecting them.", + "reason": "The skill defines the five required modes and now provides an explicit decision path for selecting them when a request is ambiguous.", "evidence_refs": [ ".agent/tasks/codex-material-3-stage-1-skill/raw/skill-mode-check.txt", ".agents/skills/material-3/SKILL.md" @@ -70,5 +70,5 @@ "release_checks": [], "open_problems_count": 0, "requires_fix": false, - "timestamp": "2026-04-14T19:50:30+03:00" + "timestamp": "2026-04-14T20:04:51.4016835+03:00" } diff --git a/.agents/skills/material-3/SKILL.md b/.agents/skills/material-3/SKILL.md index 67ccbb7..1b1fdf0 100644 --- a/.agents/skills/material-3/SKILL.md +++ b/.agents/skills/material-3/SKILL.md @@ -12,6 +12,7 @@ Use this skill only for Material Design 3 or Material You work. Stay MD3-specifi - Prefer Jetpack Compose Material 3 APIs and patterns as the primary path. - Support Flutter Material 3 as a secondary implementation path. - Keep Web support limited to tokens, CSS architecture, and component guidance unless the user explicitly asks for a constrained web implementation. +- Do not imply full Web parity with Compose unless the repo-local implementation proves it. - Treat MD3 as personal, adaptive, and expressive: start from task intent, state, context, and device class before choosing components. ## Mode selection @@ -26,6 +27,14 @@ Choose one primary mode before producing output: If a request spans multiple areas, set a primary mode and a secondary mode. Example: a dashboard shell with theme polish is `scaffold` primary and `theme` secondary. +Use this decision path when the request is ambiguous: + +- Existing screen, code path, or screenshot that needs scoring or gap analysis -> `audit` +- New app shell, screen skeleton, or navigation shell -> `scaffold` +- Window-size adaptation, navigation switching, insets, or responsive shell behavior -> `layout` +- Seed color, tokens, dynamic color, typography, shape, or elevation strategy -> `theme` +- Specific control, state model, or component choice -> `component` + ## Reference loading map Load only the references needed for the active mode: diff --git a/plugin/skills/material-3/SKILL.md b/plugin/skills/material-3/SKILL.md index 67ccbb7..1b1fdf0 100644 --- a/plugin/skills/material-3/SKILL.md +++ b/plugin/skills/material-3/SKILL.md @@ -12,6 +12,7 @@ Use this skill only for Material Design 3 or Material You work. Stay MD3-specifi - Prefer Jetpack Compose Material 3 APIs and patterns as the primary path. - Support Flutter Material 3 as a secondary implementation path. - Keep Web support limited to tokens, CSS architecture, and component guidance unless the user explicitly asks for a constrained web implementation. +- Do not imply full Web parity with Compose unless the repo-local implementation proves it. - Treat MD3 as personal, adaptive, and expressive: start from task intent, state, context, and device class before choosing components. ## Mode selection @@ -26,6 +27,14 @@ Choose one primary mode before producing output: If a request spans multiple areas, set a primary mode and a secondary mode. Example: a dashboard shell with theme polish is `scaffold` primary and `theme` secondary. +Use this decision path when the request is ambiguous: + +- Existing screen, code path, or screenshot that needs scoring or gap analysis -> `audit` +- New app shell, screen skeleton, or navigation shell -> `scaffold` +- Window-size adaptation, navigation switching, insets, or responsive shell behavior -> `layout` +- Seed color, tokens, dynamic color, typography, shape, or elevation strategy -> `theme` +- Specific control, state model, or component choice -> `component` + ## Reference loading map Load only the references needed for the active mode: