Skip to content

Input Registration and Analysis ​

Inputs are evidence sources for implementation. fe-harness divides inputs into five categories:

TypeDirectoryDescription
PRD.fe-harness/inputs/prd/Product requirements and business rules
RP.fe-harness/inputs/rp/Prototypes, page flows, interaction specs
UI.fe-harness/inputs/ui/Visual references, design files, screenshot notes
API.fe-harness/inputs/api/OpenAPI / Apifox exports
assets.fe-harness/inputs/assets/Images, icons, fonts, materials

Inspect ​

bash
fe-harness inputs inspect --json

Inspect discovers differences between input directory and manifest:

  • Which files are registered.
  • Which files are not registered.
  • Which registered items have missing files.
  • Whether manifest exists and is parseable.

Analyze ​

bash
fe-harness inputs analyze --json

Analyze extracts simple facts from text inputs and categorizes by business, interaction, and visual dimensions. It also reports same-key conflicts.

Why Original Inputs Are Read-Only by Default ​

Original inputs are evidence. Implementation process can generate analysis conclusions, coverage matrices, and task snapshots, but should not silently rewrite the evidence itself.

This strategy reduces two types of problems:

  • Requirements being "conveniently fixed" during implementation, making later tracing impossible.
  • Agent writing its inferences back to original materials, mixing evidence and conclusions.

Relationship with Design Token ​

UI and RP inputs are important sources for Token refinement. When visual conflicts occur, Token source priority is: high-fidelity UI, RP, user temporary visual requirements, project existing tokens, DESIGN principles, Harness defaults, Agent inference.

This means Agent cannot ignore newly entered UI files just because templates have defaults; nor can it overwrite high-fidelity UI because it inferred a more pleasing value.

Business-neutral by design. Project-owned by default.