Harness Intelligence Wiki
SpecsCLIIP-99-private-harness-wiki-app

Implementation Notes

Implementation Notes

Summary

  • Confirmed apps/wiki is the private Fumadocs app and canonical wiki source owner.
  • Added a package-level check-types task so root Turborepo typecheck covers the wiki app.
  • Replaced default Fumadocs app identity with Harness Intelligence wiki identity.
  • Added root metadata with a portless local fallback origin and Vercel production URL support.
  • Updated Turborepo build outputs to exclude .next/cache/** for Vercel-compatible cache behavior.
  • Preserved the existing CLI domain source and routed pages while updating project spec projection/bookkeeping.

Execution Mode

Parallel discovery, single-owner implementation. Readonly subagents inspected wiki conventions, build/deploy readiness, and harness domain separation in parallel. File edits stayed local because the app-foundation changes touched shared indexes and package configuration.

Deviations From the Plan

  • The wiki app already existed and built before IP-99 delivery, so implementation focused on integration/readiness gaps rather than scaffolding a new app.
  • Linear native blocker fields were not exposed by the available fetch payload. The Linear research endpoint failed, so sequencing used the issue hierarchy and parent links returned by _fetch.

Sanity Checks

CheckResultNotes
bun run checkPassedRepo lint/format check.
bun run check-typesPassedWiki participates through package check-types.
bun run build --filter=@punks/wikiPassedProduction Fumadocs/Next build.
jq empty on changed meta.json filesPassedFumadocs metadata remains valid JSON.
Local browser smokePassed/docs, /docs/harness, /docs/project, and /docs/cli render locally.

Acceptance Criteria Status

CriterionStatusEvidence
apps/wiki is canonical source ownerDoneapps/wiki/AGENTS.md, apps/wiki/README.md, source tree, and routed docs all state the ownership model.
Fumadocs projection does not duplicate canonical sourceDoneRouted pages summarize/link source indexes under apps/wiki/content/docs/project/domains.
Local wiki routes renderDoneBrowser smoke covered docs root, harness root, project root, and CLI domain.
CLI wiki knowledge preservedDoneExisting apps/wiki/content/docs/project/domains/cli and apps/wiki/content/docs/cli pages remain in place.
Wiki is not public landing contentDoneApp identity and docs copy call it private/internal; apps/web untouched.
Wiki package typecheck participates in root taskDoneAdded check-types script.
Vercel/Turbo output cache is compatibleDoneturbo.json excludes .next/cache/**.
Vercel deploy completed or blocked with evidenceBlockedNo .vercel/project.json exists and deployment needs a linked Vercel project/access.

Manual Review Checklist

AreaCheckHow to performExpected result
Wiki identityConfirm app is not default Fumadocs sampleOpen /docs locallyHeader/metadata identify Harness Intelligence wiki.
CLI preservationConfirm CLI domain still rendersOpen /docs/cliCLI mechanics pages are visible and separate from harness methodology.
Project docsConfirm specs projection is discoverableOpen /docs/project/specsIP-99, IP-100, and prior spec folders are listed without duplicating full spec content.
DeploymentConfirm Vercel linkageInspect .vercel/project.json or project dashboardProject root points at apps/wiki, framework is Next.js, install uses Bun, build is compatible with Turbo/Next.

Remaining Work

  • Link or create the Vercel project for apps/wiki before deployment.
  • If private access must be enforced in-app instead of by Vercel/org access, create a separate auth-scoped spec.

On this page