fix(docs): delete 5 workspace-only symlinks (correct fix for #59, which didn't work)

[hoainho]

Context

The pages build and deployment workflow has failed on every main push for 5+ days (9 consecutive failures). PR #59 attempted to fix this with a Jekyll _config.yml exclude rule — that approach did not work, and this PR is the corrected fix.

Why PR #59 failed

The Jekyll symlink_outside_site_source? check fires in entry_filter.rb during directory scan, before any exclude: filter runs. Trace from run 27066018295 (post-#59 merge):

entry_filter.rb:35:in `block in filter`
entry_filter.rb:33:in `reject`
entry_filter.rb:33:in `filter`
entry_filter.rb:74:in `symlink?`
entry_filter.rb:83:in `symlink_outside_site_source?`

The exclude list is consulted later in reader.rb:117 filter_entries, but the scan has already crashed on the symlink. _config.yml exclude rules cannot rescue symlinks that point outside the site source.

Why these symlinks exist at all

They were intentionally added in commit d39c598 docs: wire harness via workspace symlinks to wire Sisyphus harness scaffolding from /Users/nhonh/Documents/personal/docs/ on the local dev machine. Resolves fine locally, but the symlink targets don't exist on the CI runner (which has only the cloned repo, not the workspace).

Fix

Delete the 5 symlinks + the now-dead _config.yml (which had a stale exclude list). The local dev workspace wiring can be re-established by re-creating the symlinks locally — they don't need to be tracked (workspace tooling, not repo content).

Files deleted (6 total)

File	Type	Status
docs/HARNESS.md	symlink	workspace wiring
docs/HARNESS_BACKLOG.md	symlink	workspace wiring
docs/FEATURE_INTAKE.md	symlink	workspace wiring
docs/evidence/README.md	symlink	workspace wiring
docs/templates/story.md	symlink	workspace wiring
docs/_config.yml	file (from #59)	dead config

Verification (post-merge)

Expected: the next push to main will trigger pages build and deployment with conclusion: success. The Pages site (https://hoainho.github.io/react-debugger-extension/) will be live. HARNESS.local.md (the only real harness file in docs/) is preserved.

Also verified via git grep: zero references to HARNESS.md, HARNESS_BACKLOG.md, or FEATURE_INTAKE.md anywhere in the repo source code. They were docs-only artifacts.

Risk

Tiny. Pure deletion, no code logic affected. If the user wants the local workspace wiring back, the 5 ln -s commands are a one-liner per file.

Related

• PR fix(docs): unblock Pages build by excluding 5 workspace-only symlinks #59 (superseded — exclude approach doesn't work)
• Commit d39c598 (where the symlinks were first added)
• The Sat 2026-06-07 launch window: the Pages site is the marketing/landing page; having it broken during launch is a credibility hit

[gemini-code-assist]

Code Review

This pull request removes several workspace-only symlinks pointing to external documentation files, including FEATURE_INTAKE.md, HARNESS.md, and HARNESS_BACKLOG.md, as well as their corresponding exclusion rules in the configuration file. These changes clean up the repository structure. There are no review comments, and I have no additional feedback to provide.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.