project-tiny-context-harness 0.7.5 → 0.7.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +351 -345
- package/assets/README.md +535 -529
- package/assets/README.zh-CN.md +299 -293
- package/assets/agents/.gitkeep +1 -1
- package/assets/agents/AGENTS_CORE.md +52 -52
- package/assets/context_templates/architecture.md +33 -33
- package/assets/context_templates/area.md +39 -39
- package/assets/context_templates/context.toml +30 -30
- package/assets/context_templates/deployment.md +35 -35
- package/assets/context_templates/global.md +51 -51
- package/assets/context_templates/product-surface-contract.md +58 -58
- package/assets/context_templates/verification.md +32 -32
- package/assets/github/.gitkeep +1 -1
- package/assets/github/harness.yml +41 -41
- package/assets/make/.gitkeep +1 -1
- package/assets/make/ty-context.mk +48 -48
- package/assets/skills/context_development_engineer/SKILL.md +89 -89
- package/assets/skills/context_full_project_export/SKILL.md +70 -70
- package/assets/skills/context_harness_upgrade/SKILL.md +60 -60
- package/assets/skills/context_product_plan/SKILL.md +74 -74
- package/assets/skills/context_surface_contract/SKILL.md +165 -165
- package/assets/skills/context_uiux_design/SKILL.md +92 -92
- package/assets/skills/design-resource-authoring/SKILL.md +65 -0
- package/assets/skills/design-resource-authoring/references/downstream-handoff.md +126 -0
- package/assets/skills/design-resource-authoring/references/open-design-provider.md +112 -0
- package/assets/skills/design-resource-authoring/references/resource-selection.md +124 -0
- package/assets/skills/long-task-workflow/SKILL.md +82 -81
- package/assets/skills/long-task-workflow/agents/openai.yaml +4 -4
- package/assets/skills/long-task-workflow/references/authority-lifecycle.md +56 -56
- package/assets/skills/long-task-workflow/references/contract-authoring.md +88 -88
- package/assets/skills/long-task-workflow/references/evidence-design.md +69 -69
- package/assets/skills/normal-long-task/SKILL.md +12 -12
- package/assets/skills/source-plan-authoring/SKILL.md +291 -291
- package/dist/lib/profiles.js +1 -0
- package/migrations/README.md +15 -15
- package/package.json +1 -1
- package/source-mappings.yaml +25 -25
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-resource-authoring
|
|
3
|
+
description: Use when the user explicitly asks to generate, author, plan, commission, or iterate design resources; use Open Design; create a scoped wireframe, prototype, visual candidate, component/control state study, or design handoff from raw drafts, product/technical plans, optional Source Plans, visual briefs, screenshots, or existing design resources; or asks to “生成设计资源”, “使用 Open Design”, “生成原型图”, “生成高保真/低保真设计”, or “先看一个控件/页面效果” in a Minimal Context Harness project. Do not trigger for generic design discussion, UX audits, ordinary UI implementation, local CSS fixes, durable Design Authority/Context adoption, Source Plan authoring itself, or Long-Task execution.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Design Resource Authoring
|
|
7
|
+
|
|
8
|
+
Commission the smallest sufficient set of design resources from the currently available Open Design capabilities. This Skill is a thin task-local planner, provider adapter, iteration guide and handoff layer. Open Design owns its generation logic; Tiny Context owns neither its prompts nor its runtime.
|
|
9
|
+
|
|
10
|
+
## Hard boundaries
|
|
11
|
+
|
|
12
|
+
- A raw draft is a valid input. Never require, invoke, regenerate or edit a Source Plan.
|
|
13
|
+
- Never edit an initial proposal, `project_context/**`, `DESIGN.md`, a Delivery Contract, production code or tests as a side effect of design-resource work.
|
|
14
|
+
- Never make a prototype, wireframe, high-fidelity candidate, design system, Figma file, variant count or directory layout universally mandatory.
|
|
15
|
+
- Never let supplied background expand the user's explicit output scope. “One control,” “one page,” “these three pages” and “exploration only” are hard ceilings.
|
|
16
|
+
- Generated candidates are ordinary external Source. They do not select themselves, become `exact-target`, create Design Authority or prove product acceptance.
|
|
17
|
+
- Keep provider projects, runs and generated artifacts task-local until the user requests a handoff or explicitly selects a candidate.
|
|
18
|
+
- Do not install or persistently configure MCP servers, plugins, authentication or new disclosure paths without separate user authorization.
|
|
19
|
+
- Do not create a Tiny Context resource pack, provider registry, workflow state, Contract artifact, acceptance record or parallel authority lifecycle.
|
|
20
|
+
|
|
21
|
+
## Read the references
|
|
22
|
+
|
|
23
|
+
1. Always read [resource-selection.md](references/resource-selection.md) before deciding what to generate.
|
|
24
|
+
2. Read [open-design-provider.md](references/open-design-provider.md) before capability discovery, provider execution, recovery or Figma routing.
|
|
25
|
+
3. Read [downstream-handoff.md](references/downstream-handoff.md) before a handoff, selected-source preparation, accepted-decision summary or use by Source Plan/default/Long-Task workflows. A simple unselected preview may stop before this reference is needed.
|
|
26
|
+
|
|
27
|
+
## Core workflow
|
|
28
|
+
|
|
29
|
+
1. **Fix the requested-scope ceiling.** Separate background coverage from requested output coverage. Record explicit exclusions and whether the user wants exploration, handoff or selected-source preparation.
|
|
30
|
+
2. **Inventory every supplied input.** Accept raw notes, an initial proposal, product and technical plans, an optional Source Plan, visual briefs, screenshots, references and existing artifacts. Preserve each input's role as existing exact target, constraint, inspiration, current-implementation evidence or background; report unreadable or intentionally unused material and do not invent missing authority.
|
|
31
|
+
3. **Find the design gaps.** Identify only the uncertainties that block or materially improve the requested decision: information hierarchy, flow, control/state behavior, visual direction, responsive/platform behavior, reusable system detail or editable team handoff.
|
|
32
|
+
4. **Discover live capabilities.** Inspect the current Open Design agent/model, functional skills, rendering templates, design systems, plugins and export routes. Treat absent or non-enumerable capabilities honestly; never substitute a remembered catalogue.
|
|
33
|
+
5. **Choose the minimum sufficient commission.** Give every considered resource one disposition: `selected`, `optional`, `not-needed`, `unavailable` or `decision-required`, with one reason. Select multiple resources only when each closes an independent gap. Ask only when a genuine missing preference materially changes the commission; otherwise use traceable, reversible judgment.
|
|
34
|
+
6. **Commission through Open Design.** Send a product-specific, bounded commission envelope around the selected provider capability. Do not copy, restate or simulate the provider's internal template prompt. Prefer structured MCP; use the bounded fallbacks in the provider reference only when needed.
|
|
35
|
+
7. **Observe and inspect proportionally.** Keep provider execution state, artifact readiness and design suitability separate. Exploration needs only scope/corruption sanity and a visible result; handoff needs relevant structure/interaction inspection; downstream product verification remains downstream.
|
|
36
|
+
8. **Iterate within scope.** Revise the candidate from user feedback without expanding coverage or continuously rewriting the source proposal. Stop when the requested design decision is supported, the user stops, or a genuine decision/provider blocker is reached.
|
|
37
|
+
9. **Return the intent-sized result.** A simple exploration should show the artifact promptly. A handoff adds compact provenance, coverage and limitations. Selected-source preparation requires explicit selection basis and an immutable locator/hash or approved snapshot.
|
|
38
|
+
|
|
39
|
+
## Raw-draft exploration loop
|
|
40
|
+
|
|
41
|
+
An initial proposal may go directly through this Skill before `source-plan-authoring`:
|
|
42
|
+
|
|
43
|
+
```text
|
|
44
|
+
raw initial proposal
|
|
45
|
+
-> bounded design candidate
|
|
46
|
+
-> user feedback and iterations
|
|
47
|
+
-> explicit human selection/rejection
|
|
48
|
+
-> optional consolidated accepted-design-decision delta (when requested)
|
|
49
|
+
-> separately authorized revision of the initial proposal
|
|
50
|
+
-> optional source-plan-authoring(revised proposal + selected resources)
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The Skill performs only the first four transitions and returns differences as output. It does not apply the proposal revision or invoke the optional final step. The delta distinguishes accepted, rejected and unresolved choices and identifies affected surface/control/state keys when available. Do not require or emit an interim delta after every iteration: keep those observations task-local and, when requested, return one consolidated delta after the direction is final. Never continuously synchronize or write back the proposal during candidate iteration.
|
|
54
|
+
|
|
55
|
+
## Stop and route elsewhere
|
|
56
|
+
|
|
57
|
+
- Route durable UI/UX authority adoption or repair to `context_uiux_design`.
|
|
58
|
+
- Route synthesis of an implementation-ready Source Plan to `source-plan-authoring` only when the user explicitly requests that separate work.
|
|
59
|
+
- Route ordinary implementation with sufficient design authority to the default Workflow Contract.
|
|
60
|
+
- Route a complete explicit Single-Goal delivery to `long-task-workflow`.
|
|
61
|
+
- If no new resource is justified, say so and route to the appropriate existing path instead of generating filler.
|
|
62
|
+
|
|
63
|
+
## Completion response
|
|
64
|
+
|
|
65
|
+
Report the requested scope and intent, selected/omitted/unavailable resources, visible artifacts or durable locators, provider/artifact status, review actually performed, provenance appropriate to intent, unresolved decisions and forbidden inferences. For an explicit selection after raw-draft iteration, return the accepted-design-decision delta when requested, without modifying any source document; it may be deferred until the end and consolidated once.
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# Design Resource Handoff
|
|
2
|
+
|
|
3
|
+
Generated resources remain ordinary external Source. This reference preserves enough identity and meaning for later work without creating a Tiny Context-specific pack, registry or authority lifecycle.
|
|
4
|
+
|
|
5
|
+
## Candidate, selection and authority are separate
|
|
6
|
+
|
|
7
|
+
- **Candidate:** provider output proposed for review. It authorizes no fidelity.
|
|
8
|
+
- **Human selection:** an explicit user/team choice with a stated basis. It permits selected-source preparation, not automatic durable adoption.
|
|
9
|
+
- **Authority adoption:** a downstream workflow reconciles the selected Source with product/surface Context and `DESIGN.md`, records durable ownership where required and binds implementation/verification to declared conditions.
|
|
10
|
+
|
|
11
|
+
The Skill may preserve an input already classified as `exact-target`; it may not promote its own candidate to `exact-target`. Unknown coverage remains unknown.
|
|
12
|
+
|
|
13
|
+
## Intent-sized response
|
|
14
|
+
|
|
15
|
+
### Exploration
|
|
16
|
+
|
|
17
|
+
Return promptly:
|
|
18
|
+
|
|
19
|
+
- requested scope and intent;
|
|
20
|
+
- visible candidate/preview;
|
|
21
|
+
- resource dispositions and obvious limitations;
|
|
22
|
+
- provider/artifact qualifier when execution is not clean;
|
|
23
|
+
- minimal sanity review actually performed.
|
|
24
|
+
|
|
25
|
+
Do not require files, schemas, packs, hashes or validator runs for a throwaway unselected preview unless they are needed to retrieve/show it reliably.
|
|
26
|
+
|
|
27
|
+
### Handoff
|
|
28
|
+
|
|
29
|
+
Add only the fields needed for another person or workflow to consume it:
|
|
30
|
+
|
|
31
|
+
- stable resource key plus surface/control/state/target keys when known;
|
|
32
|
+
- classification: candidate, inspiration, constraint or pre-existing exact target;
|
|
33
|
+
- provider version, project/run, selected capability/template, agent/model and design-system provenance as reported live;
|
|
34
|
+
- explicit source entry or preview locator and immutable hash/snapshot when available;
|
|
35
|
+
- declared platform, viewport, mode, state, content and interaction coverage;
|
|
36
|
+
- selection basis if a human selection already exists;
|
|
37
|
+
- unresolved decisions, known limitations and forbidden inferences;
|
|
38
|
+
- outer review performed and provider status qualifier.
|
|
39
|
+
|
|
40
|
+
No dedicated Markdown/YAML file or directory is mandatory. Use concise prose for simple work and a task-local structured block when fields would otherwise become ambiguous.
|
|
41
|
+
|
|
42
|
+
### Selected-source preparation
|
|
43
|
+
|
|
44
|
+
Require explicit human selection and record who/what supplied the selection basis. Preserve the exact artifact by hash or a user-approved durable snapshot. Do not rely on a mutable preview URL. Do not choose a repository destination, edit authority files or start implementation without separate authorization.
|
|
45
|
+
|
|
46
|
+
## Accepted-design-decision delta
|
|
47
|
+
|
|
48
|
+
When raw-draft exploration leads to an explicit selection, report a delta for the separately owned proposal-revision step:
|
|
49
|
+
|
|
50
|
+
```yaml
|
|
51
|
+
selection_basis: explicit user/team decision
|
|
52
|
+
selected_resources:
|
|
53
|
+
- resource key, explicit locator and immutable hash/snapshot
|
|
54
|
+
accepted:
|
|
55
|
+
- decision and rationale
|
|
56
|
+
rejected:
|
|
57
|
+
- alternative and reason
|
|
58
|
+
unresolved:
|
|
59
|
+
- genuine remaining choice
|
|
60
|
+
impacts:
|
|
61
|
+
product_rules: []
|
|
62
|
+
information_hierarchy: []
|
|
63
|
+
surface_keys: []
|
|
64
|
+
control_keys: []
|
|
65
|
+
state_keys: []
|
|
66
|
+
interaction_rules: []
|
|
67
|
+
visual_constraints: []
|
|
68
|
+
forbidden_inference:
|
|
69
|
+
- candidate iteration did not itself revise the proposal or establish Design Authority
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
This is an explanatory shape, not a required schema. Include only known changes. Do not emit or apply a delta after every iteration: interim observations remain task-local and may be returned once as a consolidated delta when the direction is final. The Skill does not write back the proposal, decide when a separately authorized owner rewrites it, or invoke `source-plan-authoring`.
|
|
73
|
+
|
|
74
|
+
## Initial proposal and Source Plan routing
|
|
75
|
+
|
|
76
|
+
The components are independent and composable:
|
|
77
|
+
|
|
78
|
+
```text
|
|
79
|
+
raw draft -> design-resource-authoring -> candidates -> explicit selection
|
|
80
|
+
raw draft -> source-plan-authoring -> Source Plan
|
|
81
|
+
revised raw draft + selected design resources -> source-plan-authoring -> richer Source Plan
|
|
82
|
+
selected design resources -> default Workflow or Long-Task Source
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
The recommended design-first loop for substantial new Web/App work is:
|
|
86
|
+
|
|
87
|
+
1. explore from the initial proposal;
|
|
88
|
+
2. iterate inside the requested scope;
|
|
89
|
+
3. obtain explicit human selection;
|
|
90
|
+
4. when requested, return one consolidated accepted-design-decision delta;
|
|
91
|
+
5. let a separately authorized plan owner revise the proposal;
|
|
92
|
+
6. if requested, pass both the revised proposal and selected immutable resources to `source-plan-authoring`.
|
|
93
|
+
|
|
94
|
+
This is a useful path, not a universal required lifecycle. `source-plan-authoring` remains optional upstream synthesis and does not generate design resources.
|
|
95
|
+
|
|
96
|
+
## Default Workflow Contract consumption
|
|
97
|
+
|
|
98
|
+
When the user later authorizes concrete development:
|
|
99
|
+
|
|
100
|
+
1. bring the selected generated resource as ordinary Source;
|
|
101
|
+
2. perform UI Authority Closure against product/surface Context, `DESIGN.md`, tokens and declared targets;
|
|
102
|
+
3. classify the resource and confirm selection basis/coverage;
|
|
103
|
+
4. decide `Context Delta` and adopt durable facts only through their existing owners;
|
|
104
|
+
5. implement and run project-owned verification.
|
|
105
|
+
|
|
106
|
+
Open Design run success, a candidate screenshot or this handoff cannot authorize fidelity or acceptance.
|
|
107
|
+
|
|
108
|
+
## Long-Task consumption
|
|
109
|
+
|
|
110
|
+
- A selected resource and an optional Source Plan are parallel ordinary Source inputs to Contract authoring.
|
|
111
|
+
- Contract `source_paths`, bindings, verification inputs, check input paths and artifact globs should name only the stable locators/conditions they actually consume.
|
|
112
|
+
- Surface/control/state/target keys should connect product meaning, source targets, implementation and checks where applicable.
|
|
113
|
+
- Authority Lock, protected Authority Revision and Final Gate remain the only Long-Task authority lifecycle.
|
|
114
|
+
- This Skill creates no Contract Draft, outcome, receipt, Check result or Gate.
|
|
115
|
+
- A later Open Design rerun does not silently revise locked Source; the downstream workflow uses its normal revision rules.
|
|
116
|
+
|
|
117
|
+
## Forbidden inferences
|
|
118
|
+
|
|
119
|
+
Unless independently proven downstream, never infer that a generated resource:
|
|
120
|
+
|
|
121
|
+
- is selected, authoritative or accepted;
|
|
122
|
+
- covers unlisted states, viewports, modes, platforms or accessibility behavior;
|
|
123
|
+
- is a native implementation because an HTML/image preview renders;
|
|
124
|
+
- is editable in Figma because a Figma capability was listed;
|
|
125
|
+
- changed the initial proposal, Source Plan, Context, `DESIGN.md`, code or Contract;
|
|
126
|
+
- proves production fidelity, product correctness, test completion or release readiness.
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# Open Design Provider Orchestration
|
|
2
|
+
|
|
3
|
+
Use Open Design as the generation engine. This Skill supplies a bounded product commission and retrieves results; it does not recreate the provider's prompts, template logic or catalogue.
|
|
4
|
+
|
|
5
|
+
## Execution priority
|
|
6
|
+
|
|
7
|
+
1. **Structured Open Design MCP** for discovery, project/run control and artifact retrieval.
|
|
8
|
+
2. **Open Design CLI or daemon API** when MCP is unavailable or cannot expose a required current capability but equivalent structured behavior is locally available.
|
|
9
|
+
3. **Browser/desktop interaction** only for bootstrap, unavoidable UI-only selection, signed-in provider interaction, visual preview inspection or recovery. Prefer browser-specific control over general Computer Use when both can operate the page.
|
|
10
|
+
|
|
11
|
+
Do not silently install an MCP server/plugin, alter the user's global Open Design/Codex configuration, sign in, create a paid-provider dependency or expand data disclosure. Explain the exact setup need and obtain separate authorization when persistence or a new disclosure path is required.
|
|
12
|
+
|
|
13
|
+
## Live capability discovery
|
|
14
|
+
|
|
15
|
+
Discover rather than remember:
|
|
16
|
+
|
|
17
|
+
- configured agents and models, including whether Open Design's inner agent is Codex CLI;
|
|
18
|
+
- functional skills and plugins;
|
|
19
|
+
- rendering templates or project types;
|
|
20
|
+
- design systems and their selected project binding;
|
|
21
|
+
- specialist paths such as Figma, image, video or 3D/WebGL;
|
|
22
|
+
- supported project creation, run, cancellation, file and artifact operations.
|
|
23
|
+
|
|
24
|
+
Current structured tool names may include `list_agents`, `list_skills`, `list_plugins`, `create_project`, `get_project`, `get_active_context`, `start_run`, `get_run`, `cancel_run`, `list_files`, `get_file` and `get_artifact`. Feature-detect them; tool names and provider versions may evolve.
|
|
25
|
+
|
|
26
|
+
Functional skills and rendering templates are different registries. Finding `frontend-design` does not prove that a `mobile-app` or `wireframe-mobile-flow` template is installed, and a remembered template ID is not live capability evidence.
|
|
27
|
+
|
|
28
|
+
### Rendering-template discovery compatibility
|
|
29
|
+
|
|
30
|
+
Prefer, in order:
|
|
31
|
+
|
|
32
|
+
1. a live `list_design_templates`-style method/resource when the provider exposes one;
|
|
33
|
+
2. an explicit template ID supplied by the current project/user and validated by the provider;
|
|
34
|
+
3. a version-guarded structured daemon query that reads the provider's current registry;
|
|
35
|
+
4. provider UI inspection when no structured registry is exposed;
|
|
36
|
+
5. an honest `unavailable` or degraded-discovery result.
|
|
37
|
+
|
|
38
|
+
Never vendor a fallback template catalogue or guess a template ID from prior runs. Do not implement a transport helper unless the live host truly lacks a safe structured path; any helper may normalize metadata and transport only.
|
|
39
|
+
|
|
40
|
+
## Structured commission sequence
|
|
41
|
+
|
|
42
|
+
1. Record provider version, selected agent/model, functional capability, rendering template, design system and relevant plugin/export readiness as reported live.
|
|
43
|
+
2. Reuse an existing task-local project only when its scope and prior inputs match; otherwise create a bounded project.
|
|
44
|
+
3. Start a run with the product-specific commission envelope and the provider-native capability identifier.
|
|
45
|
+
4. Poll with a bounded cadence. During a long run, report meaningful progress at least once per minute without flooding the user.
|
|
46
|
+
5. Preserve run IDs and the latest provider diagnostic. Support cancellation when the user requests it and the provider exposes it.
|
|
47
|
+
6. Resolve the actual entry explicitly, retrieve the artifact/source, inspect it according to intent and preserve its immutable identity before later iterations or handoff.
|
|
48
|
+
|
|
49
|
+
Open Design may launch Codex CLI as its configured inner agent. That is provider execution, not recursive invocation of this outer Skill. Do not hardcode a model when the provider can report the current configured model.
|
|
50
|
+
|
|
51
|
+
## Separate three kinds of state
|
|
52
|
+
|
|
53
|
+
### Provider execution state
|
|
54
|
+
|
|
55
|
+
Examples: queued, running, succeeded, failed, cancelled, timed out or unknown.
|
|
56
|
+
|
|
57
|
+
### Artifact readiness
|
|
58
|
+
|
|
59
|
+
Examples: missing, partial, corrupt, retrievable, rendered or snapshot-preserved.
|
|
60
|
+
|
|
61
|
+
### Design suitability
|
|
62
|
+
|
|
63
|
+
Examples: unreviewed, scope-sane, handoff-checked, human-selected or rejected.
|
|
64
|
+
|
|
65
|
+
Never collapse these into one “success.” A provider success does not prove a good design; a complete artifact can exist even when a provider run later fails.
|
|
66
|
+
|
|
67
|
+
Use these qualifiers when needed:
|
|
68
|
+
|
|
69
|
+
- `artifact-ready/run-unreconciled`: a complete retrievable artifact exists, but the provider run remains nonterminal or inconsistent;
|
|
70
|
+
- `artifact-ready/provider-failed`: the artifact remains complete and retrievable, but the provider later reports failure/timeout.
|
|
71
|
+
|
|
72
|
+
In both cases preserve the exact run locator, last update, failure diagnostic and artifact hash. Do not claim provider success or downstream acceptance. Retry only when the promised resource is incomplete/corrupt or the user requests another attempt; do not discard a useful independently inspected artifact merely because the terminal state differs.
|
|
73
|
+
|
|
74
|
+
## Explicit entry and immutable identity
|
|
75
|
+
|
|
76
|
+
Provider project metadata may omit or stale its entry file. Resolve in this order:
|
|
77
|
+
|
|
78
|
+
1. validate an explicit project entry path when present;
|
|
79
|
+
2. enumerate project files;
|
|
80
|
+
3. identify the intended provider-native entry from the current run/output rather than guessing;
|
|
81
|
+
4. retrieve that exact file/artifact;
|
|
82
|
+
5. preserve an SHA-256 digest or immutable snapshot before selection/handoff.
|
|
83
|
+
|
|
84
|
+
A preview URL is mutable navigation, not immutable identity. It may be reported for convenience only beside project/run/entry provenance and a digest. If the user explicitly selects the resource for durable use, export or snapshot it to a user-approved location; never silently choose a repository path.
|
|
85
|
+
|
|
86
|
+
## Review proportional to intent
|
|
87
|
+
|
|
88
|
+
- **Exploration:** open/render the requested entry, confirm artifact count/scope and obvious corruption, then show it. Do not launch a packaging or validator sequence.
|
|
89
|
+
- **Handoff:** additionally inspect relevant structure, key states/transitions, viewport behavior, obvious console/runtime errors and requested interaction hooks. State exactly what was and was not checked.
|
|
90
|
+
- **Selected-source preparation:** require explicit human selection basis, preserve identity/snapshot, and prepare downstream metadata. It still does not verify production behavior.
|
|
91
|
+
|
|
92
|
+
Provider self-checks, outer artifact sanity review and downstream project verification are separate evidence layers. Never claim native rendering, accessibility, responsive coverage, product correctness or acceptance unless the appropriate downstream project checks actually prove them.
|
|
93
|
+
|
|
94
|
+
## Figma and other specialist paths
|
|
95
|
+
|
|
96
|
+
Figma is optional. Select it only when editable collaboration or library handoff materially benefits the request and a real connector/plugin/export path plus authentication is operational. A listed plugin, skill description or catalogue entry is not proof that editable Figma export works.
|
|
97
|
+
|
|
98
|
+
If Figma is requested but unavailable:
|
|
99
|
+
|
|
100
|
+
- report the missing connector/auth/export capability precisely;
|
|
101
|
+
- offer a non-Figma artifact only when it still answers the user's design decision;
|
|
102
|
+
- never relabel HTML, an image or a manifest record as an editable Figma design.
|
|
103
|
+
|
|
104
|
+
Apply the same capability/readiness rule to image, video, 3D/WebGL and other specialist providers.
|
|
105
|
+
|
|
106
|
+
## Failure and recovery
|
|
107
|
+
|
|
108
|
+
- Preserve provider diagnostics; do not replace failures with generated placeholders.
|
|
109
|
+
- Avoid unbounded polling or repeated blind reruns.
|
|
110
|
+
- Re-discover capability after provider upgrades or registry mismatches.
|
|
111
|
+
- If structured paths fail but a UI artifact exists, UI inspection may recover it while retaining the degraded-provider qualifier.
|
|
112
|
+
- If the provider is unavailable and no justified fallback exists, return `unavailable` with the minimum setup needed rather than generating with an unrelated image tool and calling it equivalent.
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# Dynamic Resource Selection
|
|
2
|
+
|
|
3
|
+
Use this reference to derive a bounded design-resource commission from the actual request. It is a decision model, not a fixed production sequence.
|
|
4
|
+
|
|
5
|
+
## 1. Establish the scope ceiling
|
|
6
|
+
|
|
7
|
+
Extract the smallest explicit output boundary before interpreting the background:
|
|
8
|
+
|
|
9
|
+
- subject: one control/component, one page, named pages, a flow or a reusable system;
|
|
10
|
+
- platform and viewport when known;
|
|
11
|
+
- modes, states and transitions explicitly requested;
|
|
12
|
+
- fidelity or editability requested, if any;
|
|
13
|
+
- exclusions such as “other pages not included,” “preview only,” “no Figma” or “do not update files.”
|
|
14
|
+
|
|
15
|
+
Rich background improves a bounded artifact. It never authorizes more artifacts. If the user supplies a complete app plan but asks to preview one button, generate at most the one-control resource.
|
|
16
|
+
|
|
17
|
+
## 2. Choose the intent
|
|
18
|
+
|
|
19
|
+
| Intent | User decision being supported | Default stopping point |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| `exploration` | “What might this look or feel like?” | Visible scoped candidate plus minimal sanity review |
|
|
22
|
+
| `handoff` | “Can another designer/developer reliably consume this?” | Project-native artifact plus provenance, coverage, limitations and relevant checks |
|
|
23
|
+
| `selected-source-preparation` | “Preserve this explicitly selected direction for later use.” | Immutable identity or approved snapshot, explicit selection basis and downstream notes |
|
|
24
|
+
|
|
25
|
+
Intent is task-local and need not be persisted. Selected-source preparation does not itself adopt Design Authority.
|
|
26
|
+
|
|
27
|
+
## 3. Inventory relevant input roles
|
|
28
|
+
|
|
29
|
+
Preserve each supplied item's actual role:
|
|
30
|
+
|
|
31
|
+
- `exact-target`: already authoritative only for its declared conditions;
|
|
32
|
+
- `constraint`: a rule that controls only its stated scope;
|
|
33
|
+
- `inspiration`: directionally useful but not fidelity authority;
|
|
34
|
+
- `current-implementation-evidence`: evidence of current behavior, not desired behavior by default;
|
|
35
|
+
- `background`: product/technical context that informs but does not expand generation scope.
|
|
36
|
+
|
|
37
|
+
An optional Source Plan is one possible input. Raw notes or an initial proposal are equally valid. Never require one merely to make the other usable.
|
|
38
|
+
|
|
39
|
+
## 4. Identify independent gaps
|
|
40
|
+
|
|
41
|
+
Ask what remains uncertain inside the scope:
|
|
42
|
+
|
|
43
|
+
- **structure:** information hierarchy, layout regions or page relationships;
|
|
44
|
+
- **flow:** navigation, branching, recovery or multi-step sequence;
|
|
45
|
+
- **behavior:** control states, transitions, gestures, feedback, loading/error/empty/disabled cases;
|
|
46
|
+
- **visual direction:** composition, typography, color, density, imagery or brand character;
|
|
47
|
+
- **platform/responsiveness:** safe areas, breakpoints, input methods or viewport behavior;
|
|
48
|
+
- **system reuse:** tokens, component variants or cross-surface rules needed by more than the requested artifact;
|
|
49
|
+
- **team editability:** a real need for collaborative editable frames/libraries or an organizational Figma handoff.
|
|
50
|
+
|
|
51
|
+
Do not manufacture a gap already resolved by selected Source.
|
|
52
|
+
|
|
53
|
+
## 5. Consider resources conditionally
|
|
54
|
+
|
|
55
|
+
| Resource | Select when it closes this gap | Usually omit when |
|
|
56
|
+
| --- | --- | --- |
|
|
57
|
+
| Control/component state study | One control's variants, anatomy, feedback or edge states are the decision | The page target already specifies those states precisely |
|
|
58
|
+
| Low-fidelity wireframe | Hierarchy, topology or flow must be judged without visual-style distraction | Structure is settled and only visual direction is unknown |
|
|
59
|
+
| High-fidelity visual candidate | Visual hierarchy, tone or composition needs selection | Existing selected targets already govern the requested conditions |
|
|
60
|
+
| Interactive prototype | Transitions, navigation, state retention or task feel must be experienced | A static decision is sufficient or the provider cannot produce genuine interaction |
|
|
61
|
+
| Flow/journey board | Multiple surfaces, branches or recovery paths must be compared together | The request is one isolated surface/control |
|
|
62
|
+
| Design-system slice | Several requested artifacts need shared tokens/components or reuse rules | One exploratory candidate does not justify a system |
|
|
63
|
+
| Component inventory/specification | Development handoff needs explicit reusable variants and states | Exploration is visual only and no reuse decision is requested |
|
|
64
|
+
| Figma handoff | Editable collaborative frames/libraries are explicitly valuable and operational | A screenshot/HTML/project-native source is sufficient or connector/auth/export is unavailable |
|
|
65
|
+
| Image/illustration/icon/media study | Bespoke content materially defines the selected direction | Generic placeholders answer the present decision |
|
|
66
|
+
|
|
67
|
+
A prototype is often valuable for new Web/App flows, but it is never automatically required. Low- and high-fidelity resources may both be selected only when they answer independent questions.
|
|
68
|
+
|
|
69
|
+
## 6. Assign a disposition to every considered resource
|
|
70
|
+
|
|
71
|
+
- `selected`: required to close a current gap;
|
|
72
|
+
- `optional`: useful, but not necessary for the current decision;
|
|
73
|
+
- `not-needed`: redundant or outside the scope ceiling;
|
|
74
|
+
- `unavailable`: justified but not currently supported/configured;
|
|
75
|
+
- `decision-required`: a genuine unresolved preference changes the commission materially.
|
|
76
|
+
|
|
77
|
+
Give one concrete reason. Do not turn `optional` into automatic extra work.
|
|
78
|
+
|
|
79
|
+
## 7. Build the commission envelope
|
|
80
|
+
|
|
81
|
+
The task-local envelope should contain only product-specific information:
|
|
82
|
+
|
|
83
|
+
```yaml
|
|
84
|
+
intent: exploration | handoff | selected-source-preparation
|
|
85
|
+
scope:
|
|
86
|
+
subjects: [named control/surface/flow keys]
|
|
87
|
+
ceiling: one-control | one-page | named-pages | named-flow | system-slice
|
|
88
|
+
platform: known-or-unknown
|
|
89
|
+
viewports: []
|
|
90
|
+
coverage:
|
|
91
|
+
required_content: []
|
|
92
|
+
required_states: []
|
|
93
|
+
required_transitions: []
|
|
94
|
+
inputs:
|
|
95
|
+
exact_targets: []
|
|
96
|
+
constraints: []
|
|
97
|
+
inspiration: []
|
|
98
|
+
background: []
|
|
99
|
+
selected_capability:
|
|
100
|
+
kind: runtime-discovered-kind
|
|
101
|
+
id: runtime-discovered-id
|
|
102
|
+
exclusions: []
|
|
103
|
+
expected_entry: known-or-provider-native
|
|
104
|
+
review_promise: minimal-sanity | handoff-checks | selected-source-snapshot
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
This is an explanatory shape, not a required file or schema. Never paste or paraphrase the Open Design capability's own seed/template prompt into it.
|
|
108
|
+
|
|
109
|
+
## 8. Iterate and stop
|
|
110
|
+
|
|
111
|
+
- Keep each revision inside the original scope ceiling unless the user explicitly expands it.
|
|
112
|
+
- Reuse the current Open Design project when that preserves context and provenance; preserve the prior artifact hash before overwriting a selected candidate.
|
|
113
|
+
- Do not create low-fi, high-fi, component boards and Figma copies merely because a process diagram lists them.
|
|
114
|
+
- Stop as soon as the requested decision is supported.
|
|
115
|
+
|
|
116
|
+
When a human explicitly selects or rejects a direction, return an accepted-design-decision delta when requested rather than editing the initial proposal. Include accepted, rejected and unresolved choices; product, information, control/state and visual implications; affected stable keys; and selected artifact locators/hashes. Do not require a delta after every iteration. Interim observations remain task-local and may be returned once as a consolidated delta after the design direction is final. A separate plan owner decides whether, when and what to revise.
|
|
117
|
+
|
|
118
|
+
## Worked scope examples
|
|
119
|
+
|
|
120
|
+
- **Large draft, one filter control:** select a control-state study if anatomy and states are uncertain; omit page/flow resources.
|
|
121
|
+
- **One page, style preview:** select one high-fidelity candidate; do not add a design-system pack or validator run.
|
|
122
|
+
- **Three-screen interaction flow:** select a low-fi flow and an interactive high-fi prototype only if topology and interaction/visual behavior are independently unresolved.
|
|
123
|
+
- **Local style fix with exact target:** select no new design resource and route to implementation.
|
|
124
|
+
- **Raw draft before Source Plan:** iterate only requested candidates, optionally return one consolidated accepted-decision delta when requested after selection, and leave both draft revision and later Source Plan authoring separate.
|