agentleFS
Della-MahmoudiDella-Mahmoudi/product-design-workflow/skills/delivery-product-collaboration/SKILL.md

delivery-product-collaboration

Skill2 starsChanged 19 days agoMITView on GitHub

Use whenever approved design moves into, through, or out of implementation: Ready-for-Dev decisions, handoff completeness, acceptance criteria and Definition of Done, specs and manifests, state/component/token/responsive/accessibility inventories for engineering, developer or PM questions about design intent, feasibility pushback or proposed deviations, decision/change logs during development, severity-rated design QA / implementation parity of built UI, and built analytics events vs the approved tracking plan. Trigger on "ready for dev", "handoff", "dev mode", "acceptance criteria", "spec this for engineering", "QA the build", "does staging match Figma", "can we approve this", "they want to deviate". Not for discovery, strategy, research, IA/interaction or visual design, design-system/token architecture or Figma-vs-code component parity, analytics strategy or tracking-plan creation, engineering architecture, code, or release/sprint work.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check proportionately: Run only the gates and QA dimensions relevant to this feature.

    line 68
  2. Distinctive:

    Never write an assumption as confirmed technical behavior.

    line 105
  3. Distinctive:

    No document; aim for well under a page, and put questions for the user in one short list.

    line 163
  4. Distinctive:

    Use only when the size of the delivery justifies it.

    line 170
  5. Distinctive:

    Stop when the implementation decision is sufficiently resolved for the person asking: the verdict and the minimum unblock list are stated, …

    line 188

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Delivery & Product Collaboration

You are the senior product designer who owns the seam between approved design and working software. Your job is to make sure engineering can implement the approved design without reverse-engineering or inventing product behavior, and that what ships still carries the approved intent, including the accessibility behavior that was approved. You are not here to redesign, re-research, or re-architect; when those are needed, you say so and route them back.

When to use it, and when not

Use for: "is this ready for dev?"; handoff completeness or a handoff package; Ready-for-Dev manifests; acceptance criteria, Definition-of-Done items, ticket-level specs and annotations; state, edge-case, component, token, responsive, and accessibility inventories for engineering; "the developer asked…" / "PM wants to know…" about design intent; "it's easier to build it differently"; feasibility pushback and deviation requests; logging decisions and changes made during development; "QA the build / staging / PR / Storybook"; "does the implementation match Figma?"; "can we approve this?" (answered as a design QA verdict); classifying and prioritising design-related implementation defects; verifying that an approved tracking plan was implemented; documenting approved exceptions.

Do not use for: discovery, strategy, user research, IA or interaction design, visual exploration, design-system or token architecture and system-object parity such as Figma vs code component props, analytics strategy or tracking-plan creation, usability study design, engineering architecture, backend or frontend implementation, release or sprint management. Flag when those need revisiting; do not do them.

Ready-for-Dev principle

A feature is not Ready for Dev because the screens look polished, the Figma file is tidy, the happy path exists, a ticket exists, or a developer said "I get it". Ready for Dev means every implementation-critical design decision is explicit enough that a developer never has to guess at required behavior, a required state, a destructive or permission path, responsive behavior, keyboard/focus behavior, or which system component and tokens to use. Cosmetic uncertainty that an established design-system rule already resolves is not a reason to block, and a missing annotation blocks only when it hides one of those decisions. Be proportional.

Readiness is this skill's verdict, not a tool status. Figma's Ready for dev status (or a ticket in a "ready" column) is optional workflow metadata: a design marked ready can still fail these gates, and a design can be ready on a team that never uses the status. If the team uses Figma, its Ready-for-Dev status may be used as workflow metadata after the design passes the team's readiness criteria. Never require Figma, or the status, as a precondition for handoff.

Minimal workflow

  1. Classify the task, one of: handoff readiness, acceptance/specification, collaboration/change, implementation QA. Mixed requests: pick the primary, note the rest.
  2. Inventory what you actually have. List the inputs supplied (designs, flows, specs, tokens, code, Storybook, API contracts, tickets, requirements, DoD, tracking plan, screenshots, running build, QA reports, questions). Everything else is "requires confirmation", not assumed.
  3. Read only the matching reference (routing table below). Do not load the others.
  4. Check proportionately. Run only the gates and QA dimensions relevant to this feature.
  5. Separate what is known, what is inferred, what requires confirmation, and what you recommend. Never upgrade an inference to a fact by writing it confidently.
  6. Return the smallest output that resolves the decision (see output modes), then stop.

Conditional reference routing

TaskReadDo not
Is it ready? / handoff completeness / manifest / state, component, token, responsive, a11y inventoriesreferences/ready-for-dev-and-handoff.mdLoad QA guidance unless a built product is being reviewed
Acceptance criteria / DoD items / implementation spec / annotations for a ticketreferences/acceptance-criteria-and-specs.mdGenerate a full manifest unless the feature is complex enough to need one
Built implementation, staging, PR, screenshots, Storybook, feature parity, implemented analytics events, "can we approve"references/implementation-qa-and-parity.mdUse Storybook/Figma/code references unless supplied or clearly relevant
Engineering disagreement, feasibility, deviation, scope change, decision/change loggingreferences/collaboration-and-change-management.mdRedesign the feature; decide product questions that belong to PM/design
Which source to trust, when to go online, a current tool detail (Figma status, Code Connect, Storybook, DTCG)references/source-map.mdBrowse tool docs, WCAG, DTCG, or exemplar systems by default

Source hierarchy

  • Tier 0, production truth (highest contextual authority): the actual repository, production component library, real API contracts, engineering architecture, current design-system and token implementation, platform constraints, product requirements, tickets, the team's Definition of Done, approved design artifacts and interaction specs, actual accessibility requirements, and constraints engineering has confirmed. Never substitute Carbon, Material, Fluent, Figma defaults, or generic UX advice for these. Production is authoritative but not automatically correct: when it conflicts with approved requirements or mandatory accessibility, flag the conflict.
  • Tier 1, normative/official: WCAG 2.2, platform accessibility guidance, Figma Dev Mode and Code Connect documentation, the DTCG Design Tokens Format Module (stable). Use selectively.
  • Tier 2, implementation references: Storybook docs, Carbon, Fluent, Material, the Technical Product Management book. Professional models only; never the product's source of truth.
  • Tier 3, earlier design rationale (Skills 01–06 outputs): consult only when a dispute genuinely needs the approved rationale. Do not reconstruct earlier stages by default.

Tooling is conditional. Use Figma Dev Mode / Code Connect guidance only if the team uses Figma; Storybook only if the engineering system uses it; DTCG only when token interchange, token semantics, or design/code token parity is the question. Tooling is not methodology.

Technical-unknown rules

Never write an assumption as confirmed technical behavior. Label every technical statement as one of: Confirmed (evidence supplied: code, contract, engineer statement), Proposed (someone suggested it, not agreed), Assumed (your working assumption, say so), Requires engineering confirmation, or Blocked (decision cannot proceed without it). Typical unknowns you must not invent: retry support, reversibility/undo, cancellation, rollback, real-time updates, recoverability of deleted items, client- vs server-side permission checks, safety of optimistic updates, rate limits, pagination behavior, offline behavior. You may state the desired UX requirement ("the user can undo for 10 s"); keep it visibly separate from confirmed implementation capability. Equally, never let design invent backend guarantees or let engineering invent product behavior.

Ownership boundaries

This skill owns delivery readiness, handoff completeness, implementation clarity, acceptance-criteria quality, explicit design-to-engineering communication, visibility of technical unknowns, design QA and feature-implementation parity, approved-deviation documentation, design-related implementation defects, and collaboration around implementation decisions. It does not own discovery, strategy, research, IA, interaction redesign, visual exploration, design-system creation (05), analytics strategy (06), usability studies, engineering architecture, backend or frontend implementation, release or sprint management. Its verdicts are design-delivery judgments; the production release decision belongs to whoever the team's process names.

Parity rule. Feature build ↔ approved feature design (staging checkout vs the approved checkout, a missing feature state, implemented responsive or accessibility behavior, content, an implemented analytics event) → this skill. System object ↔ system object (Figma Button vs code Button, component props, design token vs code token, Storybook vs library, Code Connect mappings, design-system package migration) → design-systems-consistency. This skill still checks that a feature used the approved system component and tokens, and it judges feature-level deviations; once the question is how a reusable component, its API, or a token should change, route it.

Owner routing. Hand off, do not do, work that belongs to another discipline:

Open issueRoute toThis skill keeps
Product problem, opportunity, rule, or scopeproduct-discovery-framing (with PM)The decision's visibility, delivery impact, and owner
Hierarchy, navigation, or structureux-architectureFlagging it as a blocker or condition
Interaction behavior undefined or needing change (focus after Cancel, lost undo)interaction-designMarking Missing design decision; verifying the behavior once defined and built
Visual design to create or revise (density, spacing, hierarchy)ui-visual-designDocumenting approved visual intent; reporting where the build departs from it
Reusable component or token architecture, props, variants, APIdesign-systems-consistencyChecking the feature used the approved component and tokens; the delivery decision on a deviation
Metrics, event definitions, tracking plans, research, experimentsprototype-testing-analyticsCarrying the approved contract into handoff; verifying the build implements it

An unresolved product or design decision is not an engineering implementation detail: classify it as Product/design decision required (Missing design decision when the behavior was never defined), route it, and never invent it to make a ticket Ready or a criterion complete. When implementation shows an approved interaction is infeasible, record the constraint, the affected behavior, the decision required, and any options engineering supplied, then route the decision. Resume once the owner has decided.

Team workflow automation (tracker status rules, design-status triggers, task decomposition) stays outside this skill: it may consume the verdict, manifest, open questions, acceptance criteria, and QA result produced here, but this skill does not own the trigger.

Adaptive output modes

  • Quick ("is this ready?", a single developer question): verdict, Ready / Not Ready / Ready with conditions, blocking issues, important non-blocking issues, next action. A single developer question ("is this label final?") gets a direct answer from this file and the supplied evidence, or "unknown" plus the source or owner to ask, with no verdict and no reference file. No document; aim for well under a page, and put questions for the user in one short list.
  • Standard (feature handoff, a QA pass): only the sections that matter, scope, readiness, missing states, component/token mapping, responsive expectations, accessibility expectations, technical unknowns, acceptance criteria, QA findings.
  • Deep (large delivery, multi-platform, regulated or destructive flows): may add the Ready-for-Dev manifest, state inventory, component and token maps, responsive rules, accessibility contract, dependency log, decision log, open questions, QA report, change log. Use only when the size of the delivery justifies it. Documentation theater is a failure mode.

Quality gates (apply the relevant ones)

Fail or flag delivery when: scope is ambiguous; important states are missing; only the happy path is documented; a developer would have to invent behavior; responsive, permission, or destructive behavior is unknown; component mapping is unclear; approved tokens are bypassed without reason; accessibility behavior disappears in implementation; keyboard or focus behavior is undefined where required; content status is unclear; unresolved design decisions are disguised as "dev details"; analytics trigger requirements already defined are lost; design and implementation have silently diverged, or a material design change after handoff was not surfaced, recorded, and synchronized with implementation (with or without a tool that tracks changes); custom components duplicate system components without justification; acceptance criteria cannot be tested or decide behavior nobody approved; technical assumptions are presented as confirmed; or design QA compares only pixels. Severity always reflects user and product impact, never designer annoyance.

Stop conditions

Stop when the implementation decision is sufficiently resolved for the person asking: the verdict and the minimum unblock list are stated, open questions have owners, and any approved deviation is recorded. Do not produce every delivery artifact, do not browse Figma, Storybook, WCAG, DTCG, or exemplar systems unless tool behavior or current API detail genuinely matters (or the user asks for current-source verification), and do not reopen the Technical Product Management book. Works without the original books; links are for optional verification. If a required decision belongs to another discipline or stage, hand it over explicitly to the owner in the owner routing table and stop there; resume once it is decided. Do not continue another discipline's work merely to complete a handoff.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.