brycewang-stanford/Auto-Empirical-Research-Skills / skills/24-Imbad0202-academic-research-skills/academic-pipeline
academic-pipeline
VerifiedOrchestrator for the full academic research pipeline: research -> write -> integrity check -> review -> revise -> re-review -> re-revise -> final integrity check -> finalize. Coordinates deep-research, academic-paper, and academic-paper-reviewer into a seamless 9-stage workflow with mandatory integrity verification, two-stage peer review, and reproducible quality gates. Triggers on: academic pipeline, research to paper, full paper workflow, paper pipeline, end-to-end paper, research-to-publication, complete paper workflow.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 41.5 KB |
| agents/integrity_verification_agent.md | markdown | 22.3 KB |
| agents/pipeline_orchestrator_agent.md | markdown | 21.5 KB |
| agents/state_tracker_agent.md | markdown | 15.5 KB |
| examples/full_pipeline_example.md | markdown | 16.8 KB |
| examples/integrity_failure_recovery.md | markdown | 26.4 KB |
| examples/mid_entry_example.md | markdown | 12.3 KB |
| references/claim_verification_protocol.md | markdown | 2.7 KB |
| references/mode_advisor.md | markdown | 7.8 KB |
| references/pipeline_state_machine.md | markdown | 13.1 KB |
| references/plagiarism_detection_protocol.md | markdown | 13.5 KB |
| references/team_collaboration_protocol.md | markdown | 8.9 KB |
| templates/pipeline_status_template.md | markdown | 3.7 KB |
references/pipeline_state_machine.md
View on GitHub# Pipeline State Machine v2.0 — Complete Definition
This document defines all legal states, transition conditions, transition actions, and exception handling for academic-pipeline v2.0.
---
## State Definitions
### Stage States
| State | Description |
|-------|------------|
| `pending` | Not yet started, waiting for prerequisite stage to complete |
| `in_progress` | Currently executing |
| `completed` | Completed, deliverables recorded |
| `skipped` | User chose to skip (only for non-mandatory stages) |
| `blocked` | Preconditions not met (e.g., integrity check FAIL) |
### Pipeline Global States
| State | Description |
|-------|------------|
| `initializing` | Detecting entry point and materials |
| `running` | Pipeline executing (at least one stage is in_progress) |
| `awaiting_confirmation` | Stage complete, waiting for user to confirm checkpoint |
| `paused` | User paused, can resume at any time |
| `completed` | All required stages complete, final paper produced |
| `aborted` | User abandoned (e.g., chose to abandon after Reject) |
---
## State Transition Diagram (ASCII)
```
+-------------+
| INITIALIZING|
+------+------+
|
[Detect entry point & materials]
|
+----------+----------+----------+----------+
| | | | |
v v v v v
+--------+ +--------+ +--------+ +--------+ +--------+
|Stage 1 | |Stage 2 | |Stg 2.5 | |Stage 3 | |Stage 4 |
|RESEARCH| | WRITE | |INTEGRIT| | REVIEW | | REVISE |
+---+----+ +---+----+ +---+----+ +---+----+ +---+----+
| | | | |
[checkpoint] [checkpoint] | [checkpoint] |
| | | | |
v v v v v
+--------+ +--------+ +---+----+ | |
|Stage 2 | |Stg 2.5 | |PASS? | | |
| WRITE | |INTEGRIT| +---+----+ | |
+---+----+ +---+----+ | | |
+----+----+ | |
| | | |
Yes No | |
| [Fix] | |
| [Re-verify]| |
[checkpoint] | | |
| | | |
v | | |
+--------+ | | |
|Stage 3 | <---+ | |
| REVIEW | | |
+---+----+ | |
| | |
[DECISION] | |
| | |
+---------+---------+ | |
| | | | |
Accept Minor Major | |
| Revision Revision| |
| | | | |
| [checkpoint] [checkpoint] |
| | | | |
| v v | |
| +--------+ +--------+| |
| |Stage 4 | |Stage 4 || |
| | REVISE | | REVISE || |
| +---+----+ +---+----+| |
| | | | |
| [checkpoint] [checkpoint] |
| | | | |
| v v | |
| +--------+ +--------+ |
| |Stg 3' | |Stg 3' | |
| |RE-REV. | |RE-REV. | |
| +---+----+ +---+----+ |
| | | |
| [DECISION] [DECISION] |
| | | |
| Accept Major |
| /Minor | |
| | [checkpoint] |
| | | |
| | v |
| | +--------+ |
| | |Stg 4' | |
| | |RE-REVIS| |
| | +---+----+ |
| | | |
| [checkpoint] [checkpoint] |
| | | |
v v v |
+----+--------+----------+-----+ |
| Stage 4.5 | |
| FINAL INTEGRITY | |
+----------+------------------+ |
| |
[PASS? Zero issues] |
| |
+-----+-----+ |
| | |
Yes No |
| [Fix] |
| [Re-verify] |
[checkpoint] | |
| | |
v | |
+--------+ | |
|Stage 5 | <-----+ |
|FINALIZE| |
+---+----+ |
| |
v |
+-------+ |
| END | |
+-------+ |
```
---
## Legal State Transitions
### Normal Flow Transitions
| From | To | Precondition | Action |
|------|----|-------------|--------|
| INIT | Stage 1 | User confirms starting from Stage 1 | Detect mode preference, launch deep-research |
| INIT | Stage 2 | User has research materials, confirms skipping Stage 1 | Detect materials, launch academic-paper |
| INIT | Stage 2.5 | User has complete paper | Launch integrity_verification_agent |
| INIT | Stage 3 | User has verified paper + integrity report | Confirm paper language/domain, launch reviewer |
| INIT | Stage 4 | User has review comments | Confirm paper + review comments, launch revision |
| INIT | Stage 5 | User has final draft for format conversion | Confirm format requirements, launch format-convert |
| Stage 1 | **checkpoint** | Stage 1 completed | Wait for user confirmation |
| checkpoint | Stage 2 | User confirms | handoff RQ Brief + Bibliography + Synthesis |
| Stage 2 | **checkpoint** | Stage 2 completed, Paper Draft produced | Wait for user confirmation |
| checkpoint | Stage 2.5 | User confirms | Pass Paper Draft to integrity agent |
| Stage 2.5 | **checkpoint** | PASS | Wait for user confirmation |
| Stage 2.5 | Stage 2.5 (retry) | FAIL | Fix issues, re-verify (max 3 rounds) |
| checkpoint | Stage 3 | User confirms | Pass verified paper to reviewer |
| Stage 3 | **checkpoint** | Decision produced | Wait for user confirmation |
| checkpoint | Stage 4 | Decision = Minor/Major, user confirms | Pass Revision Roadmap |
| checkpoint | Stage 4.5 | Decision = Accept, user confirms | Skip revision, go directly to final verification |
| Stage 4 | **checkpoint** | Stage 4 completed | Wait for user confirmation |
| checkpoint | Stage 3' | User confirms | Pass Revised Draft + Response to Reviewers |
| Stage 3' | **checkpoint** | Decision produced | Wait for user confirmation |
| checkpoint | Stage 4.5 | Decision = Accept/Minor, user confirms | Pass final draft to final verification |
| checkpoint | Stage 4' | Decision = Major, user confirms | Pass new Revision Roadmap |
| Stage 4' | **checkpoint** | Stage 4' completed | Wait for user confirmation |
| checkpoint | Stage 4.5 | User confirms | Pass revised draft to final verification |
| Stage 4.5 | **checkpoint** | PASS (zero issues) | Wait for user confirmation |
| Stage 4.5 | Stage 4.5 (retry) | FAIL | Fix issues, re-verify (max 3 rounds) |
| checkpoint | Stage 5 | User confirms | Pass final accepted draft |
### Special Flow Transitions
| From | To | Precondition | Action |
|------|----|-------------|--------|
| Stage 3 (Reject) | Stage 2 | User chooses to restructure | Clear Stage 2-3 state, preserve Stage 1 materials, restart Stage 2 |
| Stage 3 (Reject) | ABORT | User chooses to abandon | Save all produced materials, mark pipeline aborted |
| Stage 3' (Major) | Stage 4' | User confirms | Last revision opportunity |
| Stage 4' | Stage 4.5 | Revision complete | Go directly to final verification (no return to review) |
| Any stage | PAUSED | User says "pause" or "stop here" | Save pipeline state |
| PAUSED | Previous stage | User returns to continue | Restore pipeline state, display Dashboard |
### Prohibited Transitions (Illegal)
| From | To | Reason |
|------|----|--------|
| Stage 1 | Stage 3 | Cannot skip Stage 2 and 2.5 (unless mid-entry + has paper) |
| Stage 2 | Stage 3 | **Cannot skip Stage 2.5 (integrity check is mandatory)** |
| Stage 4 | Stage 5 | Cannot skip RE-REVIEW (revision must be re-reviewed) |
| Stage 3' | Stage 5 | **Cannot skip Stage 4.5 (final integrity check is mandatory)** |
| Stage 4' | Stage 3' | Cannot return to RE-REVIEW (max 1 round of RE-REVISE) |
| Stage 5 | Stage 3 | Cannot roll back (no review after FINALIZE) |
| completed | in_progress | Completed stages cannot restart |
---
## Material Dependency Matrix
| Material | Produced At | Consumed At | Required/Recommended |
|----------|-----------|-------------|---------------------|
| RQ Brief | Stage 1 | Stage 2 (Phase 0) | Recommended |
| Methodology Blueprint | Stage 1 | Stage 2 (Phase 0) | Recommended |
| Bibliography | Stage 1 | Stage 2 (Phase 1) | Recommended |
| Synthesis Report | Stage 1 | Stage 2 (Phase 3) | Recommended |
| Paper Draft | Stage 2 | Stage 2.5 (input) | **Required** |
| **Integrity Report (Pre)** | **Stage 2.5** | **Stage 3 (prerequisite)** | **Required** |
| **Verified Paper Draft** | **Stage 2.5** | **Stage 3 (Phase 0)** | **Required** |
| Review Reports (x5) | Stage 3 | Stage 4 (input) | Required |
| Editorial Decision | Stage 3 | Stage 4 (input) | Required |
| Revision Roadmap | Stage 3 | Stage 4 (input) | Required |
| Revised Draft | Stage 4 | Stage 3' (Phase 0) | Required |
| Response to Reviewers | Stage 4 | Stage 3' (input) | Recommended |
| **Re-Review Report** | **Stage 3'** | **Stage 4' (input)** | **Required (if Major)** |
| **Re-Revised Draft** | **Stage 4'** | **Stage 4.5 (input)** | **Required (if executed)** |
| **Integrity Report (Final)** | **Stage 4.5** | **Stage 5 (prerequisite)** | **Required** |
| Final Paper | Stage 5 | END (delivery) | Required |
---
## Exception State Handling
### Timeout
If a stage shows no progress for an extended period (e.g., Socratic mode exceeds 15 rounds without convergence):
1. state_tracker marks the stage as `stalled`
2. orchestrator provides options:
- Switch mode (socratic -> full)
- Narrow scope
- Skip this stage (non-mandatory stages only)
### Missing Materials
If required materials are found missing during transition:
1. state_tracker reports the material gap
2. orchestrator suggests returning to the stage that produces that material
3. User can choose: backfill / skip (at own risk, but cannot skip integrity checks)
### Integrity Check FAIL Loop
If Stage 2.5 or 4.5 corrections exceed 3 rounds without passing:
1. List all unverifiable items
2. User decides:
- Manually handle unverifiable items
- Remove unverifiable citations
- Continue to next stage (with "partially unverified" warning)
### Session Interruption
If the user leaves and returns:
1. orchestrator displays Progress Dashboard
2. Confirm whether to continue from breakpoint
3. Check if any outdated materials need refreshing
---
## Revision Loop Rules (v2.0)
### Simplified Revision Cycle
```
v2.0's revision cycle is simpler and more explicit than v1.0:
Stage 3 (First REVIEW)
-> Decision: Accept -> Stage 4.5
-> Decision: Minor/Major -> Stage 4
-> Stage 4 (REVISE)
-> Stage 3' (RE-REVIEW, verification)
-> Decision: Accept/Minor -> Stage 4.5
-> Decision: Major -> Stage 4' (last revision)
-> Stage 4.5 (go directly to final verification, no return to review)
Maximum 1 round of RE-REVISE, no infinite loops.
Unresolved issues -> Acknowledged Limitations.
```
### Differences from v1.0
| v1.0 | v2.0 |
|------|------|
| Max 2 review-revise cycles | Fixed 2 reviews (Stage 3 + Stage 3') + max 1 RE-REVISE |
| No integrity check | Mandatory Pre-review + Final integrity check |
| 4 reviewers | 5 reviewers (+Devil's Advocate) |
| Can skip any stage | Stage 2.5 and 4.5 cannot be skipped |
| No mandatory checkpoints | Every stage requires a checkpoint |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |