diff --git a/.gitignore b/.gitignore index 14c1168..ae6804d 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,9 @@ .DS_Store docs/ +!docs/ +docs/* +!docs/index.html +!docs/styles.css workspace/ WORKSPACE/ .project_local/ @@ -65,4 +69,4 @@ htmlcov/ # Pyright .pyright/ -runs/ \ No newline at end of file +runs/ diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..3a73aee --- /dev/null +++ b/docs/index.html @@ -0,0 +1,164 @@ + + + + + + PhD-Zero + + + + + +
+
+ + +
+
+

Research Infrastructure for Coding Agents

+

An Operating System for the Autonomous AI Scientist

+

+ PhD-Zero turns AI research workflows into reusable agent skills. It gives coding agents a + disciplined operating layer for planning, evidence gathering, experiment execution, memory, + human review, and paper writing. +

+
+ View Repository + Quick Start +
+
    +
  • Built for Codex and Claude Code
    • +
  • Structured around reusable research skills
    • +
  • Designed for evidence-backed execution, not one-shot prompting
    • +
+
+ +
+
Core Skill Stack
+
+
run-governorExecution discipline and safety
+
deep-researchLiterature search and evidence synthesis
+
experiment-executionCode runs, debugging, and experiments
+
memory-managerWorking and reusable research memory
+
paper-writingDrafting papers and research artifacts
+
+
+
+
+ +
+
+
+

Why It Exists

+

Strong models still need research discipline

+
+
+
+

From prompts to workflows

+

PhD-Zero decomposes research into reusable stages instead of treating it as a single response.

+
+
+

From guesses to evidence

+

Skills are built around search, verification, experiments, and explicit reporting.

+
+
+

From isolated runs to memory

+

Project context and memory skills let agents accumulate reusable research state over time.

+
+
+
+ +
+
+

How It Works

+

One skill source, multiple agent runtimes

+
+
+
+ Source of Truth +
.agents/skills/
+
+
β†’
+
+ Codex / Copilot-style agents +
AGENTS.md + workspace skills
+
+
β†’
+
+ Claude Code +
.claude/skills/ mirror layer
+
+
+
+ +
+
+

Quick Start

+

Get the skill layer wired correctly

+
+
+
+

1. Clone

+ 
git clone https://github.com/TenureAI/PhD-Zero.git
+cd PhD-Zero
+
+
+

2. Inspect skills

+ 
find .agents/skills -mindepth 1 -maxdepth 1 -type d
+find .claude/skills -mindepth 1 -maxdepth 1 -type l
+
+
+

3. Use with your agent

+ 
# Codex / Copilot-style agents
+cat AGENTS.md
+
+# Claude Code discovers mirrored skills
+find .claude/skills -mindepth 1 -maxdepth 1 -type l
+
+
+

+ If the skill names listed under .agents/skills and .claude/skills match, + the shared skill layer is wired correctly. +

+
+ +
+
+

Roadmap

+

From research intern to autonomous scientist

+
+
+
+ Phase 1 +

AI Research Intern

+

Scoped literature investigation, experiment planning, execution, debugging, and report drafting.

+
+
+ Phase 2 +

AI Research Collaborator

+

Persistent project context, reusable memory, better iteration loops, and stronger checkpoints.

+
+
+ Phase 3 +

Autonomous AI Scientist

+

Independent hypothesis generation, self-directed experimentation, and long-horizon research execution.

+
+
+
+
+
+ + diff --git a/docs/styles.css b/docs/styles.css new file mode 100644 index 0000000..20f354e --- /dev/null +++ b/docs/styles.css @@ -0,0 +1,357 @@ +:root { + --bg: #08111f; + --bg-soft: #0f1b33; + --panel: rgba(15, 27, 51, 0.72); + --panel-strong: #10213f; + --line: rgba(148, 163, 184, 0.2); + --text: #e2e8f0; + --muted: #9fb0c8; + --brand: #38bdf8; + --brand-strong: #0ea5e9; + --gold: #f59e0b; + --shadow: 0 24px 80px rgba(0, 0, 0, 0.32); +} + +* { + box-sizing: border-box; +} + +html { + scroll-behavior: smooth; +} + +body { + margin: 0; + font-family: "SF Pro Display", "Segoe UI", sans-serif; + background: + radial-gradient(circle at top left, rgba(56, 189, 248, 0.18), transparent 32%), + radial-gradient(circle at top right, rgba(245, 158, 11, 0.16), transparent 24%), + linear-gradient(180deg, #06101d 0%, #08111f 100%); + color: var(--text); +} + +a { + color: inherit; + text-decoration: none; +} + +code, +pre { + font-family: "SFMono-Regular", "JetBrains Mono", monospace; +} + +.page-shell { + width: min(1180px, calc(100% - 32px)); + margin: 0 auto; + padding: 24px 0 80px; +} + +.hero { + position: relative; + padding: 12px 0 32px; +} + +.topbar { + display: flex; + align-items: center; + justify-content: space-between; + gap: 16px; + padding: 18px 22px; + border: 1px solid var(--line); + border-radius: 20px; + background: rgba(8, 17, 31, 0.62); + backdrop-filter: blur(16px); +} + +.brand { + display: inline-flex; + align-items: center; + gap: 12px; + font-weight: 700; + letter-spacing: 0.02em; +} + +.brand img { + width: 36px; + height: 36px; +} + +.topbar-links { + display: flex; + flex-wrap: wrap; + gap: 14px; + color: var(--muted); +} + +.hero-grid { + display: grid; + grid-template-columns: minmax(0, 1.3fr) minmax(320px, 0.9fr); + gap: 28px; + margin-top: 28px; + align-items: stretch; +} + +.hero-copy, +.hero-card, +.feature-card, +.code-card, +.roadmap-step { + border: 1px solid var(--line); + background: var(--panel); + box-shadow: var(--shadow); +} + +.hero-copy { + padding: 34px; + border-radius: 28px; +} + +.eyebrow { + margin: 0 0 12px; + color: var(--brand); + text-transform: uppercase; + letter-spacing: 0.16em; + font-size: 0.78rem; + font-weight: 700; +} + +.hero-copy h1, +.section-heading h2 { + margin: 0; + line-height: 1; + letter-spacing: -0.04em; +} + +.hero-copy h1 { + font-size: clamp(2.8rem, 6vw, 5.5rem); + max-width: 12ch; +} + +.lede { + max-width: 58ch; + margin: 20px 0 0; + font-size: 1.08rem; + line-height: 1.72; + color: var(--muted); +} + +.hero-actions { + display: flex; + flex-wrap: wrap; + gap: 14px; + margin-top: 28px; +} + +.button { + display: inline-flex; + align-items: center; + justify-content: center; + min-height: 48px; + padding: 0 18px; + border-radius: 999px; + font-weight: 700; + transition: transform 120ms ease, background 120ms ease; +} + +.button:hover { + transform: translateY(-1px); +} + +.button.primary { + background: linear-gradient(135deg, var(--brand), var(--brand-strong)); + color: #04131d; +} + +.button.secondary { + border: 1px solid rgba(56, 189, 248, 0.35); + color: var(--text); +} + +.hero-points { + margin: 24px 0 0; + padding-left: 18px; + color: var(--muted); + line-height: 1.8; +} + +.hero-card { + padding: 24px; + border-radius: 28px; + background: linear-gradient(180deg, rgba(16, 33, 63, 0.92), rgba(10, 19, 36, 0.8)); +} + +.card-header { + margin-bottom: 16px; + color: var(--gold); + font-size: 0.86rem; + text-transform: uppercase; + letter-spacing: 0.18em; + font-weight: 700; +} + +.skill-list { + display: grid; + gap: 12px; +} + +.skill-item { + display: grid; + gap: 4px; + padding: 14px 16px; + border-radius: 18px; + background: rgba(8, 17, 31, 0.72); + border: 1px solid rgba(148, 163, 184, 0.14); +} + +.skill-item span { + color: var(--muted); + font-size: 0.95rem; +} + +.section { + margin-top: 56px; +} + +.section-heading { + margin-bottom: 20px; +} + +.section-heading h2 { + font-size: clamp(2rem, 4vw, 3.4rem); +} + +.feature-grid, +.quickstart-grid, +.roadmap { + display: grid; + gap: 18px; +} + +.feature-grid { + grid-template-columns: repeat(3, minmax(0, 1fr)); +} + +.feature-card, +.code-card, +.roadmap-step { + border-radius: 24px; + padding: 24px; +} + +.feature-card h3, +.code-card h3, +.roadmap-step h3 { + margin: 0 0 10px; + font-size: 1.2rem; +} + +.feature-card p, +.roadmap-step p, +.section-note { + margin: 0; + color: var(--muted); + line-height: 1.72; +} + +.stack-layout { + display: grid; + grid-template-columns: repeat(3, minmax(0, 1fr)); + align-items: center; + gap: 16px; +} + +.stack-column { + display: grid; + gap: 10px; +} + +.stack-label { + color: var(--muted); + font-size: 0.9rem; +} + +.stack-box { + padding: 20px; + border-radius: 22px; + border: 1px solid var(--line); + background: var(--panel-strong); + box-shadow: var(--shadow); +} + +.stack-arrow { + text-align: center; + font-size: 2rem; + color: var(--brand); +} + +.quickstart-grid { + grid-template-columns: repeat(3, minmax(0, 1fr)); +} + +.code-card { + background: rgba(10, 19, 36, 0.82); +} + +.code-card pre { + overflow-x: auto; + padding: 16px; + border-radius: 18px; + background: #07111f; + color: #cce8f5; +} + +.section-note { + margin-top: 14px; +} + +.roadmap { + grid-template-columns: repeat(3, minmax(0, 1fr)); +} + +.roadmap-phase { + display: inline-block; + margin-bottom: 12px; + color: var(--brand); + text-transform: uppercase; + letter-spacing: 0.16em; + font-size: 0.78rem; + font-weight: 700; +} + +@media (max-width: 980px) { + .hero-grid, + .feature-grid, + .quickstart-grid, + .roadmap, + .stack-layout { + grid-template-columns: 1fr; + } + + .stack-arrow { + transform: rotate(90deg); + } +} + +@media (max-width: 720px) { + .page-shell { + width: min(100% - 20px, 1180px); + } + + .hero-copy, + .hero-card, + .feature-card, + .code-card, + .roadmap-step { + padding: 20px; + border-radius: 20px; + } + + .topbar { + padding: 16px; + border-radius: 18px; + } + + .topbar-links { + justify-content: flex-start; + } +}