Remove ASTRA narrative field from skills; bump astra-tools to 0.2.10#156
Conversation
ASTRA's `narrative` field is gone (astra-spec RFC-0002); it is replaced by a single optional `description` on any Analysis, and rich write-ups are now authored as external reports that reference analysis elements by their tree-path. This updates the skill bundle accordingly. - pyproject: astra-tools>=0.2.5 -> >=0.2.10 (pulls astra-spec>=0.0.11, the narrative-free schema). - Delete the dedicated `narrative` skill (SKILL.md + references) and its docs mirror, nav entry, README/index rows, and CLAUDE.md bundle note; the paper-reproduction bundle is now five skills (four siblings). - astra skill: drop `narrative`/`authors` from the field list, remove `narrative` from the reserved-ID set, replace the Narrative section with a Description + element-addressing section. - lc-new: "Populate Narrative" -> "Populate Description". - lc-from-paper (SKILL + architect/specify/implement): ARCHITECT now authors a short per-analysis `description` (no five-section narrative, no astra-anchor weaving); SPECIFY drops the `/narrative` substrate invocation and authors `rationale:`/`claim:`/`notes:` prose directly on entries. - paper-extraction: the substrate script now emits a top-level `description:` (from the abstract) instead of `narrative.summary`, and no longer emits a `narrative.findings` cross-link; SKILL prose and the example YAML are aligned (example bumped to 0.0.11). - figure-comparison, lc-from-code, check-sentence-by-sentence: source `description`/`findings:` per-element fields instead of `narrative.*`. - docs/user pages: FINALIZE authors a `description:`. Verified: 335 tests pass; the example and the script's stub output validate against astra-spec 0.0.11. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
✅ Eval Results
Graders✅ spec_valid (1.00) Full output |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
lightcone-cli | ea3c6c0 | Commit Preview URL Branch Preview URL |
Jun 30 2026, 08:34 AM |
Builds on the reviewer's committed suggestions: also drop the 'element addressing' mention from the astra skill frontmatter, the now-orphaned 'external report references' clause from the reserved-ID note, the leftover blank line in the Description section, and the same 'richer write-up' sentence in lc-from-paper architect/specify. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
hi François this looks great. as you raised on Slack i think we should replace the narrative skill with a different one to author these new MyST documents, and i would suggest doing it in this PR since a lot of the old narrative skill instructions will be applicable to MyST documents and can be transferred over to the new skill. |
There was a problem hiding this comment.
oops, this file, the examples folder, and references to it should be deleted entirely. i should have caught it when i added this skill, it's an anecdote that i don't think will improve agent performance.
There was a problem hiding this comment.
hum ok, thanks, removing it
The unions-bmodes example is an anecdote unlikely to improve agent performance. Delete the examples/ folder and its SKILL.md reference. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Ok thanks Cail, I thought about it a bit more, mystra is not fully mature yet, so I think it's better to remove the narrative skill for now, and add a nice mystra skill once the first stable release of mystra comes out. In the meantime we are in any case not providing a system for the users to visualize the narrative fields, so from an end-user perspective nothing has changed. |
ASTRA's
narrativefield has been removed from the spec (astra-spec RFC-0002) — replaced by a single optionaldescriptionon any Analysis, with rich write-ups now authored as external reports that reference analysis elements by their tree-path. This brings the skill bundle in line.Dependency
astra-tools>=0.2.5→>=0.2.10(the release that requiresastra-spec>=0.0.11, the narrative-free schema).Skills
narrativeskill (SKILL.md+ references) and every pointer to it: docs mirror (docs/skills/narrative.md),zensical.tomlnav, README/index rows, CLAUDE.md bundle note. The paper-reproduction bundle is now five skills (four siblings).astra(spec reference): droppednarrative/authorsfrom the field list, removednarrativefrom the reserved-ID set, and replaced the## Narrativesection with a## Description+ element-addressing section.lc-new: "Populate Narrative" → "Populate Description".lc-from-paper(SKILL +architect/specify/implementreferences): ARCHITECT authors a short per-analysisdescription(no five-section narrative, noastra-anchor:weaving); SPECIFY drops the/narrativesubstrate invocation and authorsrationale:/claim:/notes:directly on entries.paper-extraction: theextract-paper-substrate.pyscript now emits a top-leveldescription:(from the abstract) instead ofnarrative.summary, and no longer emits anarrative.findingscross-link; the SKILL prose and the example YAML are aligned (example bumped to 0.0.11).figure-comparison,lc-from-code,check-sentence-by-sentence: sourcedescription/findings:per-element fields instead ofnarrative.*.description:.Remaining uses of the word "narrative" are general-English (constitution/report writing, console output) — not the ASTRA field.
Verification
uv run pytest→ 335 passedsrc/ tests/; the skill script is out of scope); no dangling links to the removed skill🤖 Generated with Claude Code