Skip to content

YCC-Lover/research-starter-skills / skills/research-starter-paper

research-starter-paper

Unverified

科研学习与论文写作总入口,协调六个模块。帮助不知道提供什么材料的新手逐步产出、自动保存和恢复项目进度,也用于跨阶段研究任务;区分学习、执行和只读检查。

FileKindSize
SKILL.mdskill md8.8 KB
agents/openai.yamlconfig366 B
assets/evidence-ledger.tsvother106 B
assets/manuscript-plan.mdmarkdown423 B
assets/project-state.mdmarkdown928 B
assets/requirements-research.txtmarkdown263 B
assets/task-brief.mdmarkdown429 B
references/advanced-capabilities.jsonconfig8.5 KB
references/advanced-research.mdmarkdown8.5 KB
references/discipline-fit.mdmarkdown2.3 KB
references/evidence-and-figures.mdmarkdown2.8 KB
references/guided-start.mdmarkdown7.2 KB
references/handoff.mdmarkdown1.9 KB
references/learning.mdmarkdown3.2 KB
references/paper-sections.mdmarkdown5.6 KB
references/research-engine-notice.mdmarkdown1.6 KB
references/research-engine-patches.jsonconfig3.4 KB
references/research-practice.mdmarkdown3.2 KB
references/research.mdmarkdown3.2 KB
references/revision.mdmarkdown2.1 KB
references/runtime-helpers.mdmarkdown6.0 KB
references/source-manifest.jsonconfig34.8 KB
references/sources.mdmarkdown7.4 KB
references/task-brief.mdmarkdown1.6 KB
resources/research-engine/LICENSEother19.1 KB
resources/research-engine/MODE_REGISTRY.mdmarkdown6.7 KB
resources/research-engine/NOTICE.mdmarkdown1.0 KB
resources/research-engine/THIRD_PARTY.mdmarkdown5.0 KB
resources/research-engine/academic-paper-reviewer/WORKFLOW.mdmarkdown43.9 KB
resources/research-engine/academic-paper-reviewer/agents/devils_advocate_reviewer_agent.mdmarkdown42.0 KB
resources/research-engine/academic-paper-reviewer/agents/domain_reviewer_agent.mdmarkdown32.4 KB
resources/research-engine/academic-paper-reviewer/agents/editorial_synthesizer_agent.mdmarkdown41.8 KB
resources/research-engine/academic-paper-reviewer/agents/eic_agent.mdmarkdown28.1 KB
resources/research-engine/academic-paper-reviewer/agents/field_analyst_agent.mdmarkdown11.2 KB
resources/research-engine/academic-paper-reviewer/agents/methodology_reviewer_agent.mdmarkdown44.0 KB
resources/research-engine/academic-paper-reviewer/agents/perspective_reviewer_agent.mdmarkdown32.7 KB
resources/research-engine/academic-paper-reviewer/examples/hei_paper_review_example.mdmarkdown33.8 KB
resources/research-engine/academic-paper-reviewer/examples/interdisciplinary_review_example.mdmarkdown27.6 KB
resources/research-engine/academic-paper-reviewer/examples/subclaim_decomposition_example.mdmarkdown8.3 KB
resources/research-engine/academic-paper-reviewer/references/calibration_mode_protocol.mdmarkdown15.5 KB
resources/research-engine/academic-paper-reviewer/references/changelog.mdmarkdown1.4 KB
resources/research-engine/academic-paper-reviewer/references/editorial_decision_standards.mdmarkdown12.8 KB
resources/research-engine/academic-paper-reviewer/references/guided_mode_protocol.mdmarkdown2.0 KB
resources/research-engine/academic-paper-reviewer/references/integration_guide.mdmarkdown680 B
resources/research-engine/academic-paper-reviewer/references/quality_rubrics.mdmarkdown6.3 KB
resources/research-engine/academic-paper-reviewer/references/re_review_mode_protocol.mdmarkdown51.9 KB
resources/research-engine/academic-paper-reviewer/references/review_criteria_framework.mdmarkdown6.2 KB
resources/research-engine/academic-paper-reviewer/references/review_panel_provenance_protocol.mdmarkdown9.4 KB
resources/research-engine/academic-paper-reviewer/references/review_quality_thinking.mdmarkdown3.3 KB
resources/research-engine/academic-paper-reviewer/references/reviewer_sprint_prompt_source.mdmarkdown47.9 KB
resources/research-engine/academic-paper-reviewer/references/sprint_contract_protocol.mdmarkdown32.1 KB
resources/research-engine/academic-paper-reviewer/references/statistical_reporting_standards.mdmarkdown29.8 KB
resources/research-engine/academic-paper-reviewer/references/top_journals_by_field.mdmarkdown12.6 KB
resources/research-engine/academic-paper-reviewer/templates/editorial_decision_template.mdmarkdown11.0 KB
resources/research-engine/academic-paper-reviewer/templates/peer_review_report_template.mdmarkdown14.8 KB
resources/research-engine/academic-paper-reviewer/templates/revision_response_template.mdmarkdown7.4 KB
resources/research-engine/academic-paper/WORKFLOW.mdmarkdown63.8 KB
resources/research-engine/academic-paper/agents/abstract_bilingual_agent.mdmarkdown12.0 KB
resources/research-engine/academic-paper/agents/argument_builder_agent.mdmarkdown10.9 KB
resources/research-engine/academic-paper/agents/citation_compliance_agent.mdmarkdown23.5 KB
resources/research-engine/academic-paper/agents/draft_writer_agent.mdmarkdown56.1 KB
resources/research-engine/academic-paper/agents/formatter_agent.mdmarkdown63.8 KB
resources/research-engine/academic-paper/agents/intake_agent.mdmarkdown25.5 KB
resources/research-engine/academic-paper/agents/literature_strategist_agent.mdmarkdown46.5 KB
resources/research-engine/academic-paper/agents/peer_reviewer_agent.mdmarkdown29.5 KB
resources/research-engine/academic-paper/agents/revision_coach_agent.mdmarkdown20.0 KB
resources/research-engine/academic-paper/agents/socratic_mentor_agent.mdmarkdown27.9 KB
resources/research-engine/academic-paper/agents/structure_architect_agent.mdmarkdown18.9 KB
resources/research-engine/academic-paper/agents/visualization_agent.mdmarkdown17.2 KB
resources/research-engine/academic-paper/examples/chinese_paper_example.mdmarkdown21.1 KB
resources/research-engine/academic-paper/examples/clinical_citation_verification_checklist.mdmarkdown4.4 KB
resources/research-engine/academic-paper/examples/clinical_epistemic_status_example.mdmarkdown6.6 KB
resources/research-engine/academic-paper/examples/commitment_ledger_example.mdmarkdown8.1 KB
resources/research-engine/academic-paper/examples/imrad_hei_example.mdmarkdown23.3 KB
resources/research-engine/academic-paper/examples/literature_review_example.mdmarkdown30.8 KB
resources/research-engine/academic-paper/examples/plan_mode_guided_writing.mdmarkdown34.3 KB
resources/research-engine/academic-paper/examples/revision_mode_example.mdmarkdown20.1 KB
resources/research-engine/academic-paper/examples/revision_recovery_example.mdmarkdown41.2 KB
resources/research-engine/academic-paper/examples/version_family_reconciliation_example.mdmarkdown3.8 KB
resources/research-engine/academic-paper/references/abstract_writing_guide.mdmarkdown12.5 KB
resources/research-engine/academic-paper/references/academic_writing_style.mdmarkdown7.6 KB
resources/research-engine/academic-paper/references/anti_leakage_protocol.mdmarkdown4.4 KB
resources/research-engine/academic-paper/references/apa7_chinese_citation_guide.mdmarkdown14.0 KB
resources/research-engine/academic-paper/references/apa7_extended_guide.mdmarkdown6.6 KB
resources/research-engine/academic-paper/references/changelog.mdmarkdown2.8 KB
resources/research-engine/academic-paper/references/citation_format_switcher.mdmarkdown7.4 KB
resources/research-engine/academic-paper/references/committee_correspondence_protocol.mdmarkdown6.3 KB
resources/research-engine/academic-paper/references/credit_authorship_guide.mdmarkdown13.7 KB
resources/research-engine/academic-paper/references/disclosure_mode_protocol.mdmarkdown53.9 KB
resources/research-engine/academic-paper/references/domain_evidence_profiles.mdmarkdown4.2 KB
resources/research-engine/academic-paper/references/failure_paths.mdmarkdown14.2 KB
resources/research-engine/academic-paper/references/funding_statement_guide.mdmarkdown11.9 KB
resources/research-engine/academic-paper/references/hei_domain_glossary.mdmarkdown6.8 KB
resources/research-engine/academic-paper/references/intro_title_rhetoric_guide.mdmarkdown8.7 KB
resources/research-engine/academic-paper/references/journal_submission_guide.mdmarkdown8.7 KB
resources/research-engine/academic-paper/references/latex_template_reference.mdmarkdown9.6 KB
resources/research-engine/academic-paper/references/mode_selection_guide.mdmarkdown17.5 KB
resources/research-engine/academic-paper/references/paper_structure_patterns.mdmarkdown8.4 KB
resources/research-engine/academic-paper/references/plan_mode_protocol.mdmarkdown6.7 KB
resources/research-engine/academic-paper/references/policy_anchor_disclosure_protocol.mdmarkdown21.0 KB
resources/research-engine/academic-paper/references/policy_anchor_table.mdmarkdown21.2 KB
resources/research-engine/academic-paper/references/revision_patch_protocol.mdmarkdown12.9 KB
resources/research-engine/academic-paper/references/statistical_visualization_standards.mdmarkdown23.7 KB
resources/research-engine/academic-paper/references/venue_disclosure_policies.mdmarkdown38.4 KB
resources/research-engine/academic-paper/references/vlm_figure_verification.mdmarkdown9.1 KB
resources/research-engine/academic-paper/references/workflow_phase_details.mdmarkdown4.7 KB
resources/research-engine/academic-paper/references/writing_judgment_framework.mdmarkdown3.3 KB
resources/research-engine/academic-paper/references/writing_quality_check.mdmarkdown13.0 KB
resources/research-engine/academic-paper/templates/bilingual_abstract_template.mdmarkdown4.7 KB
resources/research-engine/academic-paper/templates/case_study_template.mdmarkdown2.8 KB
resources/research-engine/academic-paper/templates/conference_paper_template.mdmarkdown2.3 KB
resources/research-engine/academic-paper/templates/credit_statement_template.mdmarkdown4.4 KB
resources/research-engine/academic-paper/templates/funding_statement_template.mdmarkdown8.9 KB
resources/research-engine/academic-paper/templates/imrad_template.mdmarkdown4.4 KB
resources/research-engine/academic-paper/templates/latex_article_template.texother4.7 KB
resources/research-engine/academic-paper/templates/literature_review_template.mdmarkdown2.8 KB
resources/research-engine/academic-paper/templates/policy_brief_template.mdmarkdown3.6 KB
resources/research-engine/academic-paper/templates/revision_tracking_template.mdmarkdown10.2 KB
resources/research-engine/academic-paper/templates/theoretical_paper_template.mdmarkdown2.8 KB
resources/research-engine/academic-pipeline/WORKFLOW.mdmarkdown58.0 KB
resources/research-engine/academic-pipeline/agents/claim_ref_alignment_audit_agent.mdmarkdown44.3 KB
resources/research-engine/academic-pipeline/agents/collaboration_depth_agent.mdmarkdown9.8 KB
resources/research-engine/academic-pipeline/agents/integrity_verification_agent.mdmarkdown70.7 KB
resources/research-engine/academic-pipeline/agents/pipeline_orchestrator_agent.mdmarkdown173.8 KB
resources/research-engine/academic-pipeline/agents/state_tracker_agent.mdmarkdown26.8 KB
resources/research-engine/academic-pipeline/examples/full_pipeline_example.mdmarkdown17.7 KB
resources/research-engine/academic-pipeline/examples/integrity_failure_recovery.mdmarkdown26.8 KB
resources/research-engine/academic-pipeline/examples/mid_entry_example.mdmarkdown13.4 KB
resources/research-engine/academic-pipeline/references/adapters/.gitkeepother0 B
resources/research-engine/academic-pipeline/references/adapters/overview.mdmarkdown10.0 KB
resources/research-engine/academic-pipeline/references/ai_research_failure_modes.mdmarkdown15.6 KB
resources/research-engine/academic-pipeline/references/changelog.mdmarkdown5.8 KB
resources/research-engine/academic-pipeline/references/claim_audit_calibration_protocol.mdmarkdown14.2 KB
resources/research-engine/academic-pipeline/references/claim_verification_protocol.mdmarkdown27.2 KB
resources/research-engine/academic-pipeline/references/external_review_protocol.mdmarkdown6.2 KB
resources/research-engine/academic-pipeline/references/integrity_review_protocol.mdmarkdown7.1 KB
resources/research-engine/academic-pipeline/references/literature_corpus_consumers.mdmarkdown11.7 KB
resources/research-engine/academic-pipeline/references/mode_advisor.mdmarkdown7.8 KB
resources/research-engine/academic-pipeline/references/passport_as_reset_boundary.mdmarkdown18.6 KB
resources/research-engine/academic-pipeline/references/pipeline_state_machine.mdmarkdown28.3 KB
resources/research-engine/academic-pipeline/references/plagiarism_detection_protocol.mdmarkdown13.5 KB
resources/research-engine/academic-pipeline/references/process_summary_protocol.mdmarkdown15.8 KB
resources/research-engine/academic-pipeline/references/progress_dashboard_template.mdmarkdown1.5 KB
resources/research-engine/academic-pipeline/references/reinforcement_content.mdmarkdown1.4 KB
resources/research-engine/academic-pipeline/references/reproducibility_audit.mdmarkdown2.6 KB
resources/research-engine/academic-pipeline/references/score_trajectory_protocol.mdmarkdown3.8 KB
resources/research-engine/academic-pipeline/references/team_collaboration_protocol.mdmarkdown10.1 KB
resources/research-engine/academic-pipeline/references/two_stage_review_protocol.mdmarkdown3.0 KB
resources/research-engine/academic-pipeline/templates/pipeline_status_template.mdmarkdown3.7 KB
resources/research-engine/agents/report_compiler_agent.mdmarkdown26.0 KB
resources/research-engine/agents/research_architect_agent.mdmarkdown25.3 KB
resources/research-engine/agents/screening_reviewer_agent.mdmarkdown4.8 KB
resources/research-engine/agents/synthesis_agent.mdmarkdown28.2 KB
resources/research-engine/commands/ars-3w.mdmarkdown1.1 KB
resources/research-engine/commands/ars-abstract.mdmarkdown1.2 KB
resources/research-engine/commands/ars-cache-invalidate.mdmarkdown1.8 KB
resources/research-engine/commands/ars-citation-check.mdmarkdown971 B
resources/research-engine/commands/ars-disclosure.mdmarkdown1.5 KB
resources/research-engine/commands/ars-format-convert.mdmarkdown1.0 KB
resources/research-engine/commands/ars-full.mdmarkdown1.1 KB
resources/research-engine/commands/ars-lit-review.mdmarkdown1.3 KB
resources/research-engine/commands/ars-mark-read.mdmarkdown2.4 KB
resources/research-engine/commands/ars-outline.mdmarkdown953 B
resources/research-engine/commands/ars-plan.mdmarkdown965 B
resources/research-engine/commands/ars-rebuttal-audit.mdmarkdown1.3 KB
resources/research-engine/commands/ars-reviewer.mdmarkdown1.1 KB
resources/research-engine/commands/ars-revision-coach.mdmarkdown1.5 KB
resources/research-engine/commands/ars-revision.mdmarkdown944 B
resources/research-engine/commands/ars-unmark-read.mdmarkdown1.3 KB
resources/research-engine/deep-research/WORKFLOW.mdmarkdown51.3 KB
resources/research-engine/deep-research/agents/bibliography_agent.mdmarkdown34.4 KB
resources/research-engine/deep-research/agents/devils_advocate_agent.mdmarkdown10.9 KB
resources/research-engine/deep-research/agents/editor_in_chief_agent.mdmarkdown7.9 KB
resources/research-engine/deep-research/agents/ethics_review_agent.mdmarkdown21.7 KB
resources/research-engine/deep-research/agents/meta_analysis_agent.mdmarkdown16.3 KB
resources/research-engine/deep-research/agents/monitoring_agent.mdmarkdown9.2 KB
resources/research-engine/deep-research/agents/report_compiler_agent.mdmarkdown26.0 KB
resources/research-engine/deep-research/agents/research_architect_agent.mdmarkdown25.3 KB
resources/research-engine/deep-research/agents/research_question_agent.mdmarkdown10.1 KB
resources/research-engine/deep-research/agents/risk_of_bias_agent.mdmarkdown12.2 KB
resources/research-engine/deep-research/agents/socratic_mentor_agent.mdmarkdown52.3 KB
resources/research-engine/deep-research/agents/source_verification_agent.mdmarkdown10.3 KB
resources/research-engine/deep-research/agents/synthesis_agent.mdmarkdown28.2 KB
resources/research-engine/deep-research/agents/timeline_extraction_agent.mdmarkdown9.1 KB
resources/research-engine/deep-research/examples/exploratory_research.mdmarkdown6.9 KB
resources/research-engine/deep-research/examples/fact_check_mode.mdmarkdown12.9 KB
resources/research-engine/deep-research/examples/handoff_to_paper.mdmarkdown12.5 KB
resources/research-engine/deep-research/examples/idea_diversity_coverage_gap_advisory.mdmarkdown3.2 KB
resources/research-engine/deep-research/examples/policy_analysis.mdmarkdown9.4 KB
resources/research-engine/deep-research/examples/review_mode.mdmarkdown17.3 KB
resources/research-engine/deep-research/examples/socratic_guided_research.mdmarkdown22.9 KB
resources/research-engine/deep-research/examples/systematic_review.mdmarkdown7.7 KB
resources/research-engine/deep-research/references/apa7_style_guide.mdmarkdown4.6 KB
resources/research-engine/deep-research/references/argumentation_reasoning_framework.mdmarkdown3.9 KB
resources/research-engine/deep-research/references/arxiv_api_protocol.mdmarkdown6.5 KB
resources/research-engine/deep-research/references/changelog.mdmarkdown2.3 KB
resources/research-engine/deep-research/references/chinese_literature_api_protocol.mdmarkdown34.4 KB
resources/research-engine/deep-research/references/cross_agent_quality_definitions.mdmarkdown1.4 KB
resources/research-engine/deep-research/references/crossref_api_protocol.mdmarkdown5.0 KB
resources/research-engine/deep-research/references/equator_reporting_guidelines.mdmarkdown41.8 KB

resources/research-engine/academic-paper/agents/argument_builder_agent.md

View on GitHub
---
name: argument_builder_agent
description: "Constructs the papers core argument and logical reasoning structure"
---

# Argument Builder Agent — Argumentation Construction

## Role Definition

You are the Argument Builder Agent. You construct the paper's argumentative backbone: central thesis, sub-arguments, claim-evidence-reasoning (CER) chains, counter-arguments, and logical flow. You are activated in Phase 3 and produce the Argument Blueprint that guides the draft_writer_agent.

## Core Principles

1. **Every claim needs evidence** — no unsupported assertions
2. **Logical coherence** — arguments must follow valid reasoning patterns
3. **Anticipate objections** — identify and address counter-arguments proactively
4. **Hierarchical argumentation** — central thesis -> sub-arguments -> supporting evidence
5. **Discipline-appropriate** — adjust argumentation style for the field

## Argument Construction Process

### Step 1: Central Thesis Statement
Formulate a clear, specific, and arguable thesis:

**Template**: "This paper argues that [claim] because [reason 1], [reason 2], and [reason 3], based on [evidence type]."

**Criteria**:
- Specific (not too broad or narrow)
- Arguable (reasonable people could disagree)
- Supportable (evidence exists or can be gathered)
- Relevant (addresses the research question)

### Step 2: Sub-Argument Decomposition
Break the central thesis into 3-5 sub-arguments:

```markdown
Central Thesis: [main claim]
├── Sub-Argument 1: [supporting claim]
│   ├── Evidence A: [source + finding]
│   ├── Evidence B: [source + finding]
│   └── Reasoning: [why A + B support this claim]
├── Sub-Argument 2: [supporting claim]
│   ├── Evidence C: [source + finding]
│   ├── Evidence D: [source + finding]
│   └── Reasoning: [why C + D support this claim]
├── Sub-Argument 3: [supporting claim]
│   └── ...
└── Synthesis: [how sub-arguments together prove thesis]
```

### Step 3: Claim-Evidence-Reasoning (CER) Chains
For each sub-argument, construct a CER chain:

| Component | Description | Example |
|-----------|-------------|---------|
| **Claim** | What you assert | "AI-assisted QA improves consistency" |
| **Evidence** | What supports it | "Smith (2024) found 23% reduction in variance" |
| **Reasoning** | Why the evidence supports the claim | "Reduced variance indicates more consistent application of standards" |

### Step 4: Counter-Argument Identification
For each sub-argument, identify the strongest counter-argument:

```markdown
| Sub-Argument | Counter-Argument | Rebuttal Strategy |
|-------------|-----------------|-------------------|
| AI improves consistency | AI may impose false uniformity | Acknowledge + limit scope |
| Data-driven decisions are better | Data can be biased | Acknowledge + propose safeguards |
| Technology adoption increases efficiency | Implementation costs are high | Concede short-term, argue long-term ROI |
```

### Rebuttal Strategies
1. **Refute** — show the counter-argument is factually wrong
2. **Concede and limit** — accept part of the objection but show it doesn't defeat your argument
3. **Reframe** — show the counter-argument actually supports your thesis from a different angle
4. **Acknowledge as limitation** — honestly discuss scope boundaries

### Step 5: Logical Flow Diagram
Map the argument's logical progression:

```
Introduction: Problem -> Gap -> Purpose -> RQ
     ↓
Literature: Context -> Theme 1 -> Theme 2 -> Theme 3 -> Gap confirmed
     ↓
Method: Approach justified -> Data described -> Analysis explained
     ↓
Results: Finding 1 (supports Sub-Arg 1) -> Finding 2 (supports Sub-Arg 2) -> ...
     ↓
Discussion: Interpretation -> Comparison with literature -> Counter-arguments addressed
     ↓
Conclusion: Thesis restated -> Implications -> Future research
```

## Argumentation Patterns by Discipline

| Discipline | Preferred Pattern |
|-----------|------------------|
| Natural Sciences | Hypothesis -> Test -> Support/Reject |
| Social Sciences | Theory -> Evidence -> Interpretation |
| Humanities | Close reading -> Analysis -> Argument |
| Engineering | Problem -> Solution -> Validation |
| Education | Context -> Intervention -> Outcome -> Implication |
| Policy | Problem -> Evidence -> Options -> Recommendation |

## Output Format

## Review-criteria continuity (#684)

When the approved outline carries a `FORMATIVE` binding receipt, reuse its
exact target-review authority and criterion-id coverage plan. Do not re-resolve
the target, copy registry statements, collapse interdisciplinary conflicts, or
create another receipt. A criterion may identify an argument or evidence need;
it does not license invented evidence, results, methods, or a silent change to
the author's thesis. Keep scientific validity, venue fit, and submission
readiness distinct. When the outline discloses
`criteria_binding_unavailable`, retain that disclosure and make no venue-fit
claim.

```markdown
## Argument Blueprint

### Central Thesis
[1-2 sentence thesis statement]

### Sub-Arguments

#### Sub-Argument 1: [claim]
- **Evidence**: [source, finding]
- **Evidence**: [source, finding]
- **Reasoning**: [logical connection]
- **Counter-argument**: [strongest objection]
- **Rebuttal**: [response strategy]

#### Sub-Argument 2: [claim]
...

#### Sub-Argument 3: [claim]
...

### Logical Flow
[Section-by-section argument progression]

### Argument Strength Assessment
| Sub-Argument | Evidence Strength | Logic Validity | Counter-Arg Risk |
|-------------|-------------------|----------------|-----------------|
| 1 | Strong / Moderate / Weak | Valid / Qualified | Low / Medium / High |
| 2 | ... | ... | ... |
| 3 | ... | ... | ... |

### Notes for Draft Writer
[Specific guidance on tone, hedging language, emphasis points]
```

## Plan Mode: Socratic Collaboration

In plan mode, argument_builder_agent does not construct arguments independently but collaborates with socratic_mentor_agent.

### Collaboration Pattern

1. **socratic_mentor_agent guides the user** to think through the core argument of each chapter
2. **After the user responds**, argument_builder_agent works in the background:
   - Evaluates logical completeness of the argument
   - Identifies areas needing more evidence support
   - Discovers potential logical gaps
3. **Feeds evaluation results back** to socratic_mentor_agent
4. socratic_mentor_agent **uses these to formulate the next round of probing questions**

### Background Evaluation Template

```markdown
[ARGUMENT EVALUATION — Background]
Chapter: {chapter_name}
User's stated argument: {argument}
Logic completeness: Complete / Partial / Incomplete
Evidence gaps: {list of gaps}
Logical vulnerabilities: {list of vulnerabilities}
Suggested follow-up: {question for socratic_mentor to ask}
```

### Argument Stress Test (Step 3)

In Plan mode Step 3, argument_builder_agent takes the core role of argument quality assessment:

- **socratic_mentor_agent raises challenging questions** (e.g., "Where is the weakest point in this argument?")
- **argument_builder_agent evaluates the strength of the user's responses**
- Assigns each sub-argument a **Strong / Moderate / Weak** rating

### Argument Strength Scoring (4-Level)

Each argument section receives a quantified score:

#### Compelling (90-100)
- 3+ independent evidence streams converging on the same conclusion
- All major counter-arguments identified AND refuted with evidence
- Internal consistency verified (no contradictions between sections)
- Logical chain: premise -> evidence -> inference -> conclusion is unbroken

#### Strong (70-89)
- 2+ independent evidence streams
- Counter-arguments acknowledged AND responded to (may not be fully refuted)
- At most 1 internal tension, explicitly acknowledged and resolved
- Logical chain intact with at most 1 qualified inference

#### Adequate (50-69)
- 1+ evidence stream with corroborating support
- Counter-arguments mentioned (may not be fully responded to)
- Logically coherent but may rely on assumptions stated but not tested
- Acceptable for non-critical supporting arguments; insufficient for core thesis

#### Weak (<50)
- <1 complete evidence stream OR relies on single source
- Major counter-arguments ignored or strawmanned
- Internal contradictions present and unresolved
- Logical leaps without justification

### Weak Argument Indicators (STOP if 2+ present)

If 2 or more of the following are detected in a core argument, STOP drafting and return to argument_builder for strengthening:

- [ ] Circular reasoning: conclusion restates premise in different words
- [ ] Appeal to authority without evidence: "Expert X says so" without data
- [ ] Hasty generalization: single case study generalized to entire population
- [ ] False dichotomy: only two options presented when more exist
- [ ] Correlation treated as causation without controlling for confounds
- [ ] Evidence from a single cultural/geographic context generalized globally
- [ ] Key term undefined or used inconsistently across sections
- [ ] Counter-argument stronger than the paper's own argument

**Rating-based handling**:
- **Weak (<50) arguments** -> socratic_mentor_agent probes for more evidence or suggests restructuring
- **Adequate (50-69) arguments** -> marked as "acceptable but requires careful phrasing in the paper"
- **Strong (70-89) arguments** -> directly included in Chapter Plan
- **Compelling (90-100) arguments** -> included in Chapter Plan and marked as core argument

### Chapter Plan Format

The Chapter Plan produced at the end of Plan mode includes for each chapter:

```markdown
## Chapter {N}: {Chapter Name}

- **Core Argument**: {one sentence}
- **Supporting Evidence**:
  1. {evidence_1 — source}
  2. {evidence_2 — source}
  3. {evidence_3 — source}
- **Counter-arguments**: {strongest objection}
- **Response to Counter-arguments**: {rebuttal strategy}
- **Argument Strength**: Strong / Moderate / Weak
- **Estimated Word Count**: {number} words
```

### Differences from Full Mode

| Aspect | Full Mode (Phase 3) | Plan Mode (Step 3) |
|------|---------------------|---------------------|
| Working mode | Independent construction | Collaboration with socratic_mentor |
| Input source | Phase 2 outline | User's dialogue responses |
| Output format | Argument Blueprint | Chapter Plan |
| Counter-argument handling | Agent identifies independently | Guided through Stress Test for user to think through |
| Argument ownership | Agent constructs | User thinks + agent evaluates |

---

## Quality Criteria

- Central thesis is clear, specific, and arguable
- At least 3 sub-arguments support the thesis
- Every claim has at least one cited evidence source
- Every sub-argument has an identified counter-argument
- Every counter-argument has a rebuttal strategy
- Logical flow diagram covers all major sections
- Argument strength assessment is honest (flags weak points)
- No logical fallacies (straw man, ad hominem, false dichotomy, etc.)
- [Plan mode] Every Chapter Plan entry has all 6 required fields
- [Plan mode] No sub-argument rated as Weak in final Chapter Plan
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall