Skip to content

Consolidate guides into astra-reference and prism-reference#55

Merged
lhparker1 merged 3 commits into
mainfrom
consolidate-guides
Mar 30, 2026
Merged

Consolidate guides into astra-reference and prism-reference#55
lhparker1 merged 3 commits into
mainfrom
consolidate-guides

Conversation

@lhparker1
Copy link
Copy Markdown
Member

@lhparker1 lhparker1 commented Mar 30, 2026

Summary

  • Splits the monolithic prism-reference.md into two focused guides:
    • astra-reference.md — spec structure, what an ASTRA analysis is, decisions (identification + syntax), parameterization, constraints, recipes, universes, insights, sub-analyses (when to split, worked examples, anti-patterns, composition mechanics)
    • prism-reference.md — CLI commands, sub-analysis scaffolding, status interpretation, failure diagnosis
  • Folds decision-guide.md into the Decisions section of astra-reference.md
  • Updates all skill references (prism-new, prism-build, prism-migrate), template CLAUDE.md, session-start.sh, and tests

Test plan

  • Plugin sync tests pass (pytest -k sync)
  • Verify skills reference correct guide files during /prism-new, /prism-build, /prism-migrate

🤖 Generated with Claude Code

Signed-off-by: lhparker1 liamholdenparker@gmail.com

Split the monolithic prism-reference.md into two focused guides:
- astra-reference.md: spec structure, decisions (what is/isn't a decision),
  parameterization, constraints, recipes, universes, insights, sub-analyses
- prism-reference.md: CLI commands, sub-analysis scaffolding, status, failure diagnosis

Folds decision-guide.md into the Decisions section of astra-reference.
Folds sub-analysis guidance (when to split, worked examples, anti-patterns,
composition mechanics) into astra-reference. Updates all skill, template,
script, and test references.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Mar 30, 2026

❌ Eval Results

Metric Value
Score 0.25
Build complete
Cost $0.52
Turns 34
Duration 232s
Prism 0.1.dev1+g1144ada17 (1144ada1)
Results Download

Graders

✅ spec_valid (1.00)
❌ all_materialized (0.00)

Full output
iles/bulk-upload "HTTP/1.1 200 OK"
14:20:07 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:07 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:08 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:08 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:08 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:08 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:08 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:09 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:09 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:09 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:09 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:09 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:10 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:10 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:10 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:20:10 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/04e4b744-5792-411f-be5b-094c53c251a0/files/bulk-upload "HTTP/1.1 200 OK"
14:24:04 prism.eval.sandbox Deleted sandbox for trial build-snae-0
  snae trial 0: score=0.25 incomplete

Prism: 0.1.dev1+g1144ada17 (HEAD 1144ada1)
ASTRA: 0.1.2.dev3+geb1ec1df5

  Eval Results: Scores  
┏━━━━━━┳━━━━━━━━━━━━━━━┓
┃ Task ┃     Score     ┃
┡━━━━━━╇━━━━━━━━━━━━━━━┩
│ snae │ 0.25 +/- 0.00 │
│      │  pass@k: 0%   │
└──────┴───────────────┘

   Eval Results: Cost &   
         Duration         
┏━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ Task ┃ Cost / Duration ┃
┡━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ snae │      $0.52      │
│      │      232s       │
└──────┴─────────────────┘

Total: 1 trials, $0.52, 232s

Results saved to: eval-results/build-1144ada1/results.json

lhparker1 and others added 2 commits March 30, 2026 15:55
ASTRA's feature/prior-insights-findings branch renames `insights` to
`prior_insights` and adds `findings`. Update all guides, agent prompts,
skill definitions, and templates to match.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Remove skill commands table (skills are self-discoverable)
- Move development workflow, spec-code invariant, and HPC execution
  sections from template into prism-reference.md
- Replace Analysis Context section with general Working Notes section
- Update prism-new skill to target Working Notes instead

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lhparker1 lhparker1 requested a review from EiffL March 30, 2026 14:19
Copy link
Copy Markdown
Member

@EiffL EiffL left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Mar 30, 2026

Developer Certificate of Origin

All contributors have signed the DCO. This PR is ready to merge.

Status

@lhparker1
Copy link
Copy Markdown
Member Author

I have read the Developer Certificate of Origin and I hereby sign the DCO for this PR

@lhparker1 lhparker1 merged commit fd2b420 into main Mar 30, 2026
7 of 8 checks passed
@aboucaud aboucaud deleted the consolidate-guides branch May 8, 2026 10:46
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.

2 participants