README

Density decision handoff

This package translates the interface-density research into a working set for design-system practitioners. It is intended to help a product designer, design-system designer, engineer, and accessibility partner move from evidence to a governed pilot without treating proposed values or architecture as settled.

What this package supports

• Understanding the density problem and the public architectural precedents.
• Separating research findings from the current PDS proposal.
• Auditing PDS component geometry and bindings.
• Comparing viable density mechanisms using shared criteria.
• Planning a representative pilot.
• Recording decisions, exclusions, risks, and unresolved questions.

It does not define production density values. The current PDS snapshot does not preserve the complete Figma alias and component-binding graph, so that graph and the component metric inventory remain prerequisites.

Recommended reading path

Before the working session

1. Decision brief
2. Cross-system comparison
3. Density token-model analysis
4. PDS density architecture proposal

Use individual system reports and the practitioner token views when evidence needs to be audited in more detail.

During the working session

1. Use the workshop guide to establish scope and review the proposal.
2. Use the architecture option worksheet to compare mechanisms without collapsing them into product themes.
3. Begin the component metric inventory.
4. Record provisional decisions in the decision record.

After the working session

1. Complete the component and Figma binding audit.
2. Update unresolved decisions with evidence.
3. Use the pilot plan to prototype and validate representative components.
4. Do not generate production compact values until the participating metrics, constraints, and aliases are known.

Package contents

File	Purpose
Decision brief	Concise summary of what is supported, proposed, and still unknown.
Architecture options	Neutral comparison worksheet for the five evidence-based models and a hybrid pilot.
Component metric inventory	Audit template for geometry, type, icons, targets, bindings, and participation.
Workshop guide	Suggested facilitation sequence and outputs.
Pilot plan	Gated sequence from token-graph recovery through validation.
Decision record	Reusable record for architecture and governance decisions.

Evidence boundary

Research claims remain in the system reports and synthesis documents. These handoff files organize those claims for decision-making; they do not add external-system values or represent workshop prompts as research findings.