Skip to content

IMPLEMENTATION_PLAN.md

Latest commit

 

History

History
98 lines (79 loc) · 2.66 KB

IMPLEMENTATION_PLAN.md

File metadata and controls

98 lines (79 loc) · 2.66 KB
Raw

GraphPath — Implementation Plan

Milestone 1 — Connectivity

  • Next.js project
  • TypeScript
  • Neo4j driver
  • Zod environment validation
  • CognoDB connection
  • /api/health

Milestone 2 — Graph foundation

  • Graph model
  • Deterministic idempotent seed
  • Core relationships
  • 2+ hop prerequisite traversal
  • Graph verification script

Milestone 3 — Query/API layer

  • Role listing
  • Role detail
  • User profile
  • Skill-gap analysis
  • Bounded prerequisite path
  • Centralized API errors
  • Parameterized Cypher

Milestone 4 — Product UI

  • Replace starter Next.js page
  • Role selector
  • Skill coverage indicator
  • Current/missing skill panels
  • Loading/error states
  • Role detail screen
  • Learning path screen
  • Graph visualization
  • Interactive node selection / relationship inspection
  • Responsive polish
  • Empty states for all graph journeys

Milestone 5 — Graph experience

  • Visual node/edge explorer
  • Click a skill to inspect relationships
  • Prerequisite path visualization
  • Related technologies
  • Projects demonstrating a skill
  • Learning resources

Milestone 6 — AI assistant

  • Intent extraction
  • ROLE_REQUIREMENTS
  • SKILL_GAP
  • LEARNING_PATH
  • RELATED_TECHNOLOGIES
  • PROJECTS_FOR_SKILL
  • Grounded response formatter
  • AI unavailable fallback

Milestone 7 — Quality and submission

  • Regression tests for API validation and sanitized errors
  • Graph node normalization tests
  • AI intent allowlist tests
  • Interactive graph usability: drag, pan, zoom, reset, selection
  • Architecture diagram documentation
  • Submission checklist
  • Demo script / interview walkthrough draft
  • Run final npm test in the user's environment
  • Run final npm run typecheck in the user's environment
  • Run final npm run lint in the user's environment
  • Run final npm run build in the user's environment
  • Run npm run verify:graph against the final CognoDB instance
  • Deployment
  • Final browser screenshots
  • Short demo recording
  • GitHub cleanup/push
  • Submit repository and demo link

Current next action

Milestones 1–6 are implemented. Milestone 7 is now the release phase. The graph explorer has been upgraded for readability and direct manipulation, and the repository now includes architecture, submission, and demo documentation.

Run the final local verification suite:

npm test
npm run typecheck
npm run lint
npm run build
npm run verify:graph

Then perform the external release tasks listed in docs/submission-checklist.md.