Repo Upgrade Pack: README, community health files, CI, pilot-kit - #1
Merged
Conversation
LICENSE.md was a pending-selection placeholder that conflicted with the real MIT LICENSE, causing GitHub's 'multiple licenses' warning. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
Replaces the minimal README with a fuller draft: shields.io badges, a Mermaid diagram of the three-layer architecture, an explicit safety boundary section, audience guide, and roadmap snapshot. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
Adds the community health files GitHub surfaces automatically, all anchored to this project's non-negotiable rule: synthetic/de-identified data only, human validation stays final. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
One paragraph per folder covering what lives there, its state (draft/stable/experimental), and how it connects to the concept paper, turning the folder tree into a guided tour. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
Fix repository-code URL casing, resolve the license field now that LICENSE.md is gone, and add a preferred-citation for the concept paper plus version/date so GitHub's Cite button has something meaningful. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
Compiles every Python prototype and validates the example badge JSON files against badge-metadata-schema.json on every push/PR, so a green check quietly signals engineering discipline. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
Assembles existing consent, teacher-validation, and rubric documents into one classroom-facing kit, and adds a teacher walkthrough of the learning loop plus a mock-wallet slide outline for introducing badges to students and families before any real badge is issued. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
1280x640 PNG rendered from an HTML source via headless Chromium, matching the README's mission/tagline/three-layer messaging. Upload to Settings > General > Social preview manually — GitHub doesn't expose that setting through the API. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017mpX1bitYfFC5vMfNEgb53
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this change?
Implements the Phase 1-3 items from the Agentic-Education Upgrade Pack that can be done through repo files (the rest — About sidebar, social preview upload, pinning, Discussions, Zenodo DOI — need manual GitHub Settings/account actions and are called out below).
LICENSE.md(keptLICENSE, MIT) — clears GitHub's "MIT, Unknown licenses found" flagREADME.md— badges, Mermaid architecture diagram, safety boundary, audience guide, roadmap snapshotCONTRIBUTING.md,CODE_OF_CONDUCT.md,SECURITY.md,.github/PULL_REQUEST_TEMPLATE.mdagents/,framework/,governance/,papers/,prototypes/,badges/,missions/,proposals/,docs/,gh600/)CITATION.cff— correct repo URL, resolve license field, addpreferred-citationfor the concept paper plus version/date.github/workflows/ci.yml— compiles all Python prototypes and validates the example badge JSON againstbadge-metadata-schema.jsonpilot-kit/— assembles the consent template, a new teacher walkthrough of the learning loop, and a mock-wallet slide outline (the research-to-classroom bridge)assets/social-preview.png— a 1280x640 banner rendered from HTML via headless Chromium, ready to upload to SettingsWhy?
Requested repo polish/credibility pass ("Agentic-Education Upgrade Pack") to fix the license conflict, make the repo self-explanatory folder-by-folder, add standard community health files, and add a first classroom-facing pilot kit.
Checklist
pilot-kit/is a first draft skeleton, not a completed/run pilot, so the roadmap item stays unchecked intentionallyStill needs manual action (not doable via repo files/API)
assets/social-preview.pngat Settings → General → Social previewv0.1.0release (a localv0.1.0tag was created but couldn't be pushed — this session's push credentials are scoped to this branch only)Test plan
python -m py_compileon every.pyfile in the repobadge-metadata-schema.jsonwithjsonschemalocally — both passGenerated by Claude Code