Content
53%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.
A well-organized pattern catalog with genuinely concrete Turtle and SPARQL examples for a specialized ontology domain, weakened by basic BDI theory explanations Claude already knows and a broken references section that advertises four detailed documentation files that do not exist. The T2B2T workflow is present but scattered rather than operationalized.
Suggestions
Either create the four referenced files in references/ or remove the References section — currently every referenced path is dangling, which actively misleads navigation.
Trim the Core Concepts section: Claude already knows what beliefs, desires, intentions, and the endurant/perdurant distinction are; keep only the bdi: vocabulary mapping.
Promote the T2B2T paradigm into an explicit numbered workflow with a validation step (e.g., run the competency questions after generating triples) instead of leaving it split between a section and guideline #8.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ontology-specific patterns (bdi: vocabulary, T2B2T, notation table) earn their tokens, but the Core Concepts section re-explains basic BDI theory Claude already knows ('Belief: What the agent believes to be true about the world', DOLCE endurant/perdurant distinctions), and the intro paragraph pads with buzzphrases like 'supporting deliberative reasoning, explainability, and semantic interoperability'. This matches anchor 3 (mostly efficient but includes some unnecessary explanation or could be tightened) rather than 4, since multiple sections could be trimmed. | 3 / 5 |
Actionability | Most guidance is concrete and copy-adaptable: complete Turtle patterns for the cognitive chain, world-state grounding, temporal validity, and executable SPARQL competency questions. The Python LAG example calls undefined helpers (serialize_ontology, extract_rdf_triples, retry_with_feedback) and the SEMAS Prolog uses illustrative custom syntax, which are minor gaps — fitting anchor 4 (mostly executable guidance with minor gaps) rather than 5's fully copy-paste-ready coverage. | 4 / 5 |
Workflow Clarity | A three-phase sequence exists (T2B2T: translate RDF to beliefs, execute BDI reasoning, project back to RDF) and the competency questions act as a validation checkpoint, but the sequence is scattered between the T2B2T section and guideline #8 rather than presented as an operational workflow, and there are no explicit error-recovery or checkpoint steps in the main flow. This fits anchor 3 (steps listed but validation gaps; sequence present but checkpoints implicit) better than 4's clear sequence with most checkpoints present. | 3 / 5 |
Progressive Disclosure | The References section points to four files ('bdi-ontology-core.md', 'rdf-examples.md', 'sparql-competency.md', 'framework-integration.md') but no references/ directory or bundle files exist — every referenced path is dangling. Meanwhile the complete RDF examples and full competency queries are inlined in the body anyway, fitting anchor 2 (content that clearly belongs in separate files is inlined) combined with references that mislead rather than aid navigation; this keeps it below anchor 3's 'references present' with genuine structure behind them. | 2 / 5 |
Total | 12 / 20 Passed |