docs+feat: faculty-extension workflow and AI-generated draft labels#65
Open
ValentinJSchmidt wants to merge 3 commits into
Open
docs+feat: faculty-extension workflow and AI-generated draft labels#65ValentinJSchmidt wants to merge 3 commits into
ValentinJSchmidt wants to merge 3 commits into
Conversation
Add an "Extending To A New Faculty" section so maintainers and agents can adapt the portable skill package to another faculty, program, or university without inventing a new structure each time. The section restates the meta-skill-first rule, lists the minimum inputs for a new faculty package, separates the reusable core skills from faculty-specific public data, points to the existing reference schemas for the expected Markdown structure, and names the durable source-of-truth files plus portability and privacy guardrails. Closes #58 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Require draft-thesis-contact and generate-thesis-directions to mark their outputs with a clear "AI-generated" label so students treat the contact email and proposal sketches as drafts to review, personalize, and disclose rather than finished or official artifacts. Mirror the note in the AGENTS.md skill responsibilities. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
ValentinJSchmidt
changed the title
A first sociology faculty-extension test produced a clean seed index but left it orphaned: find-university-chairs, find-recent-papers, and match-thesis-advisors hardcoded the single references/professors/INDEX.md, so an added faculty could never be read. Teach the three reader skills to read the seed index matching the student's faculty (references/<faculty>/professors/INDEX.md) and fall back to the default ML/CS index. Document the faculty namespace and the selection/fallback rule in the AGENTS.md faculty-extension workflow so new faculties are actually wired up. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
1 participant
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.
Summary
Maintainability changes to the portable skill package, plus a refinement from the first faculty-extension test:
AGENTS.md.Motivation
AGENTS.mdlacked guidance for porting it to a new faculty.references/professors/INDEX.md, so no added faculty could be read.What Changed
Faculty extension (
AGENTS.md)## Extending To A New Facultysection: meta-skill-first rule, six minimum inputs, reusable-core vs. faculty-specific data, expected Markdown reference structure, source-of-truth + portability/privacy guardrails.references/<faculty>/professors/INDEX.mdnamespace and the reader-skill selection/fallback rule.Faculty-aware reader skills
find-university-chairs,find-recent-papers,match-thesis-advisors: read the seed index matching the student's faculty (references/<faculty>/professors/INDEX.md), falling back to the default ML/CSreferences/professors/INDEX.md. Default path unchanged (tests depend on it).AI-generated draft labels
draft-thesis-contact: output includes a clear "AI-generated draft" label.generate-thesis-directions: proposal sketches carry a clear "AI-generated" label.AGENTS.md: mirrored in both skills' Outputs.Bookkeeping
STATUS.md: dated log lines +Last updatebump.How to Run / Test
Passes (25 passed, 8 skipped).
Closes #58
🤖 Generated with Claude Code