Skip to content

feat: per-project literature — project-local bibliography with deliberate upstream promotion#50

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/per-project-literature
Jul 10, 2026
Merged

feat: per-project literature — project-local bibliography with deliberate upstream promotion#50
Jammy2211 merged 1 commit into
mainfrom
feature/per-project-literature

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Closes #49.

Summary

Implements the hybrid literature rule for science projects:

  • Create scaffold generates wiki/project/bibliography.md — the project-local literature home, one ## section per paper in the same shape as the shared sources/*.md (so promotion upstream is a verbatim copy); public arXiv/DOI refs only, never PDF paths. Hybrid rule stated once in its header.
  • Thin AGENTS.md gains a Literature bullet: general concepts → shared wiki/literature/ via refer-back (one source of truth); analysis-specific papers → the project page.
  • al_ingest_paper gains a "Target — project-local or shared?" step: inside a project (detected via project.yaml + refer-back AGENTS.md) the default is the project page, with read-only canonical-key reuse; the shared wiki flow (canonical .bib, sources/, log.md, validate-citations) runs only in the assistant clone or on explicit promotion. Frontmatter description + skills README updated.

The deferred guided paper-intake step at project creation stays evidence-gated (recorded on #49), per the prompt.

Scripts Changed

None — documentation/skill templates only (skills/al_ingest_paper.md, skills/start-new-project.md, skills/README.md).

Validation

  • --check-citations: 90 files, 388 citations, 0 missing, 0 warnings.
  • Consistency read: scaffold header ↔ AGENTS.md bullet ↔ ingest target rules use the same location + promotion language.

Readiness

Heart YELLOW on the standing 6-reason set only (human-acked repeatedly 2026-07-10); docs-only, not on the library release train.

🤖 Generated with Claude Code

…i on promotion only (#49)

Create scaffolds wiki/project/bibliography.md (hybrid rule in its header:
analysis-specific papers live in the project, general concepts refer back to
the shared wiki); thin AGENTS.md gains a Literature bullet; al_ingest_paper
gains a target-selection step — project-local default inside a science
project (canonical key reused read-only when known), shared wiki/literature/
only from the assistant clone or on explicit promotion (verbatim section copy
+ canonical .bib/sources/log/validate-citations). Guided paper-intake at
creation stays deferred/evidence-gated per the prompt.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Jammy2211
Jammy2211 merged commit 35b6e4e into main Jul 10, 2026
1 check failed
@Jammy2211
Jammy2211 deleted the feature/per-project-literature branch July 10, 2026 10:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: per-project literature — project-local bibliography with deliberate upstream promotion

1 participant