Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 6 additions & 16 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Project Overview

**lightcone-cli** is Lightcone Research's agentic layer for ASTRA (Agentic Schema for Transparent Research Analysis). It ships the `lc` executable and Claude Code skills/hooks used during interactive analysis work.
**lightcone-cli** is Lightcone Research's agentic layer for ASTRA (Agentic Schema for Transparent Research Analysis). It ships the `lc` executable. The Claude Code skills and hooks used during interactive analysis work ship separately, from the [agent-skills](https://github.com/LightconeResearch/agent-skills) marketplace as the `lightcone` plugin; `lc init` registers that marketplace.

- **ASTRA** = pure specification: schema, validation, prior insights & findings, evidence verification, helpers, minimal CLI
- **lightcone-cli** = agentic layer: Claude Code skills, project scaffolding, **Snakemake-based execution**, container builds
Expand Down Expand Up @@ -49,9 +49,7 @@ astra.yaml ── snakefile generator ──> .lightcone/Snakefile
src/lightcone/ # namespace — NO __init__.py
├── cli/ # Click surface
│ ├── __init__.py # exposes main()
│ ├── commands.py # init, run, status, verify, build
│ ├── plugin.py # get_plugin_source_dir
│ └── claude/ # force-included Claude plugin bundle (in installed wheel only)
│ └── commands.py # init, run, status, verify, build
├── engine/ # execution substrate — Snakemake-based
│ ├── __init__.py
│ ├── manifest.py # write_manifest, sha256_dir, code_version — the integrity layer
Expand All @@ -66,17 +64,9 @@ src/lightcone/ # namespace — NO __init__.py
├── cli.py # `lc eval` subcommand group
├── harness.py, sandbox.py, graders.py, build.py, report.py, models.py

claude/lightcone/ # Claude plugin source — force-included into the wheel
├── skills/ # lc-new, lc-from-code, lc-from-paper,
│ # lc-feedback, ralph;
│ # paper-reproduction bundle: lc-from-paper (entry),
│ # ralph (loop substrate),
│ # paper-extraction, figure-comparison,
│ # check-sentence-by-sentence
│ # (see skills/README.md for the full bundle map)
├── agents/ # lc-extractor
├── templates/ # Project CLAUDE.md template
└── scripts/ # Session hooks (bash): venv activation, validate-on-save, session-start primer
# Skills, hooks, and the lc-extractor subagent are NOT in this repo. They ship
# from github.com/LightconeResearch/agent-skills as the `lightcone` plugin.
# `lc init` registers that marketplace in .claude/settings.json.

tests/ # pytest — mirrors src/ structure
pyproject.toml # hatchling + hatch-vcs, ASTRA + Snakemake as deps
Expand Down Expand Up @@ -152,7 +142,7 @@ Global config (`~/.lightcone/config.yaml`) is auto-created with defaults on firs
| Change manifest semantics | `src/lightcone/engine/manifest.py` + `tests/test_manifest.py` | Bump `SCHEMA_VERSION`; add a test |
| Change Snakefile shape | `src/lightcone/engine/snakefile.py` + `tests/test_snakefile.py` | Includes a `snakemake -n` parse test |
| Add container features | `src/lightcone/engine/container.py` | `compute_image_tag()`, build/resolve functions |
| Create a skill | `claude/lightcone/skills/` | SKILL.md with YAML frontmatter (`name`, `description`, `allowed-tools`) |
| Create or edit a skill | [`LightconeResearch/agent-skills`](https://github.com/LightconeResearch/agent-skills) | Skills live in that repo, not here |

## Test Patterns

Expand Down
28 changes: 21 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,23 +18,37 @@ care of the rest — specification, execution, and provenance.
uv tool install lightcone-cli
lc init my-analysis
cd my-analysis
claude
claude # trust the folder to install the lightcone plugin
```

The skills ship as a plugin, not with `lightcone-cli`. `lc init` registers the
[agent-skills](https://github.com/LightconeResearch/agent-skills) marketplace,
and Claude Code offers to install the `lightcone` plugin when you trust the
folder. To install it by hand:

```bash
claude plugin marketplace add LightconeResearch/agent-skills
claude plugin install lightcone@lightcone-research
```

Then tell the agent what you have to start from — a research question
(`/lc-new`), existing code (`/lc-from-code`), or a paper to reproduce
(`/lc-from-paper`).
(`/lightcone:new`), existing code (`/lightcone-experimental:from-code`), or a
paper to reproduce (`/lightcone-experimental:from-paper`).

→ [Full getting-started guide](https://docs.lightconeresearch.org/user/getting-started/)

## Skills

Skills live in the
[agent-skills](https://github.com/LightconeResearch/agent-skills) marketplace.

| Skill | What it does |
|---|---|
| [`/lc-new`](https://docs.lightconeresearch.org/skills/lc-new/) | Scope a new analysis from a research question into a full `astra.yaml` spec |
| [`/lc-from-code`](https://docs.lightconeresearch.org/skills/lc-from-code/) | Bring an existing codebase into ASTRA |
| [`/lc-from-paper`](https://docs.lightconeresearch.org/skills/lc-from-paper/) | Reproduce a published paper end-to-end |
| [`/lc-feedback`](https://docs.lightconeresearch.org/skills/lc-feedback/) | File a bug report with version and error context auto-collected |
| `/lightcone:new` | Scope a new analysis from a research question into a full `astra.yaml` spec |
| `/lightcone:report` | Author the MyST report that references `astra.yaml` elements by path |
| `/lightcone:feedback` | File a bug report with version and error context auto-collected |
| `/lightcone-experimental:from-code` | Bring an existing codebase into ASTRA |
| `/lightcone-experimental:from-paper` | Reproduce a published paper end-to-end |

## Capabilities

Expand Down
113 changes: 0 additions & 113 deletions claude/lightcone/agents/lc-extractor.md

This file was deleted.

30 changes: 0 additions & 30 deletions claude/lightcone/hooks.json

This file was deleted.

23 changes: 0 additions & 23 deletions claude/lightcone/scripts/activate-venv.sh

This file was deleted.

79 changes: 0 additions & 79 deletions claude/lightcone/scripts/session-start.sh

This file was deleted.

44 changes: 0 additions & 44 deletions claude/lightcone/scripts/validate-on-save.sh

This file was deleted.

Loading
Loading