Skip to content

Disclose repository guidance progressively - #68

Merged
GiggleLiu merged 2 commits into
mainfrom
improve/progressive-repo-guidance
Sep 23, 2026
Merged

GiggleLiu merged 2 commits into
mainfrom
improve/progressive-repo-guidance

Conversation

@nzy1997

@nzy1997 nzy1997 commented Sep 21, 2026

Copy link
Copy Markdown
Collaborator

PR #62 mixed repository guidance with several unrelated skill behavior changes. This focused PR makes the contributor instructions cheaper to load: CLAUDE.md points to the README catalog and keeps only repository-wide invariants, while the pre-0.3 KB migration procedure moves to an on-demand document.

This follows OpenAI's Rethinking skills and prompts for GPT-6 Astra, specifically progressive disclosure and task-relevant repository instructions. It is the documentation slice split from #62 after review feedback.

Validation

  • python3 scripts/validate_skills.py: 16 skills pass
  • python3 -m pytest -q: 268 passed, 5 skipped
  • git diff --check: clean

Keep the concrete validator/test file names for the description convention,
and repoint the README migration link at docs/kb-migration.md.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@GiggleLiu

Copy link
Copy Markdown
Member

Polished on top of your commit (8bdadc0): kept the concrete validator/test file names in the description-convention paragraph, and repointed the README's migration link at docs/kb-migration.md since the CLAUDE.md section it referenced is gone.

@GiggleLiu
GiggleLiu merged commit 9273ae6 into main Sep 23, 2026
1 check passed
@GiggleLiu
GiggleLiu deleted the improve/progressive-repo-guidance branch September 23, 2026 07:37
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