Content
68%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable content with concrete executable code and a well-organized reference structure, but it is held back by repeated warnings that inflate the token budget and a deploy/build workflow that lacks explicit validation feedback loops.
Suggestions
Deduplicate the vite.config.js and manifest path/entrypoint warnings — state each once in its primary section and reference it from Common Pitfalls rather than repeating the full explanation.
Add an explicit numbered scaffold→build→validate→deploy workflow with a validate→fix→retry checkpoint (e.g., run `foundry apps validate`, fix errors, re-validate, then `foundry apps deploy`).
Move the extended Foundry-JS API code examples (collections, workflows, LogScale, cloud functions) into references/foundry-js.md, keeping only a concise quick-start snippet inline to reduce overlap with the reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining basic concepts (React/Vue/Shoelace), but several warnings are repeated three times (vite.config.js, manifest path/entrypoint) and the 'SYSTEM INJECTION — READ THIS FIRST' role-framing block is padding that could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready CLI commands with exact flags, npm install snippets, and concrete executable code for FalconApi, collections, workflows, LogScale, cloud functions, events, and iframe origin validation, covering the common cases. | 5 / 5 |
Workflow Clarity | The scaffold→build→validate→deploy sequence is present but distributed across sections, and validation checkpoints are implicit rather than an explicit validate→fix→retry loop; for a deploy/publish workflow this lack of explicit feedback loops caps the score. | 3 / 5 |
Progressive Disclosure | A clear 'Reading Guide' table maps tasks to seven real one-level-deep reference files and inline links are well signaled, but substantial inline Foundry-JS API examples duplicate content that also has a dedicated references/foundry-js.md file, leaving a minor organization gap. | 4 / 5 |
Total | 15 / 20 Passed |