HarperFast / HarperFast/skills
Auto-sync generation failure (5b2b8bb)
- Dominant language
- JavaScript
- Stars
- 3
- Forks
- 0
- Avg merge
- 3d 7h
- Merged PRs (30d)
- 8
Description
Auto-sync generation failed for docs SHA `5b2b8bb46407fd7a5e90124ef4dda192e4c43c08`.
Opened automatically by `.github/workflows/generate.yaml`. Check the [workflow run](https://github.com/HarperFast/skills/actions/runs/34882982507) for the full error.
**Common causes and fixes (Story 4 in docs/plans-archive/docs-driven-skills.md):**
- Source file renamed or moved — update `sources[].path` in `rules.manifest.yaml`.
- Section heading renamed or removed — update `sources[].section`.
- Must-cover assertion no longer in source — update `must_cover` or the section changed.
- Regeneration dropped a fact its sources still document — the model restructured a
rule and lost content. Re-run generation, or if the removal is correct, record it
under `rules[].allow_dropped` in the manifest.
After fixing, regenerate locally (`npm run generate -- --docs-path `) and open a fix PR.
Contributor guide
Research direction
Open the linked workflow run and start with .github/workflows/generate.yaml to identify the generation error. Read the relevant guidance in docs/plans-archive/docs-driven-skills.md, then inspect rules.manifest.yaml and the affected documentation source. Regenerate with npm run generate -- --docs-path ; done means generation succeeds and a fix PR is opened.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions, javascript, yaml
- Domain
- build-system, ci-cd, documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100