HarperFast / HarperFast/skills

Auto-sync generation failure (b1001d7)

Open
#91 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
3
Forks
0
Avg merge
3d 7h
Merged PRs (30d)
8

Description

Auto-sync generation failed for docs SHA `b1001d7290cf3347b9338acf9a642601ca4bddfb`.

Opened automatically by `.github/workflows/generate.yaml`. Check the [workflow run](https://github.com/HarperFast/skills/actions/runs/34828846628) 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

Open the contributing guide

Research direction

Start with the linked workflow run and .github/workflows/generate.yaml to identify the generation error, then compare the affected source entries in rules.manifest.yaml with Story 4 in docs/plans-archive/docs-driven-skills.md. Run npm run generate -- --docs-path locally after correcting the relevant path, section, must_cover, or allow_dropped entry. Done means generation succeeds and the fix is submitted in a PR.

Written by the indexing model from the issue text.

Assessment

Tech stack
github-actions, javascript
Domain
build-system, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.