Orchestrator for the full academic research pipeline with automated project state tracking. Manages the transition between RESEARCH, WRITE, REVIEW, and PUBLISH states. Features: shell-based file management, automatic YAML frontmatter synchronization (status: active/archived), and wiki-link [[ ]] reference management.
Orchestrator for the full academic research pipeline with automated project state tracking. Manages the transition between RESEARCH, WRITE, REVIEW, and PUBLISH states. Features: shell-based file management, automatic YAML frontmatter synchronization (status: active/archived), and wiki-link [[ ]] reference management.
Academic Pipeline — Project State & Lifecycle Orchestrator
This skill manages the physical and logical lifecycle of an academic project. It ensures that files are in the right place, metadata is accurate, and internal references are synchronized across the Obsidian vault.
Project States
Drafts: Initial research and first-pass writing.
Frontmatter: status: active, phase: draft
Directory: Projects/[Name]/01_Drafts/
Revisions: Post-review or internal editing phase.
Frontmatter: status: active, phase: revision
Directory: Projects/[Name]/02_Revisions/
Publications: Finalized, verified, and formatted versions.
Frontmatter: status: archived, phase: final
Directory: Projects/[Name]/03_Publications/
Core Operations
1. State Tracking & File Migration
When a project moves from one stage to another, the pipeline MUST:
Use run_shell_command to move files between directories.
Rename files to include versioning (e.g., Paper_v1_Draft.md -> Paper_v2_Revision.md).
Every time a file is moved or modified, the pipeline verifies and updates the frontmatter:
Verification: Ensure title, date, status, and phase exist.
Update: Change status: active to status: archived once a paper reaches the Publications state.
Tool: Use replace or write_file to update the top block of the Markdown file.
3. Wiki-Link [[ ]] Management
The pipeline ensures that the index.md (Project Hub) and the individual sections are linked:
Hub Sync: The index.md must contain a dynamic list of [[Links]] to all files in the project folders.
Reference Sync: If a section (e.g., Methodology.md) is renamed, the pipeline must update all [[Methodology]] links in other files to the new name using replace with allow_multiple: true.
Workflow (Transition Gates)
Gate A: Research -> Draft (WRITE)
Action: Create project directory structure.
Metadata: Set status: active, phase: draft.
Gate B: Draft -> Review (REVIEW)
Action: Move files to 02_Revisions/.
Metadata: Set phase: revision.
Link: Update index.md to point to the revision folder.
Gate C: Review -> Final (PUBLISH)
Action: Move final validated files to 03_Publications/.
Metadata: Set status: archived, phase: final.
Action: Generate the "Scientific Integrity Report" (via academic-paper-reviewer) and link it in the index.md.
Technical Instructions for the Agent
Use Shell for Structure: Always use run_shell_command to maintain the directory hierarchy.
Atomic Updates: When updating a file's state, update both its physical location and its internal YAML metadata in a single turn if possible.
Link Integrity: Before finishing a transition, grep for the old filename to ensure no broken [[ ]] links remain in the project.
Reporting: Always provide a "Pipeline Status Update" after a transition:
