Repository navigation
Add the roadmap and set up the workflow kit - #2
Merged
Merged
Conversation
Write down the programme this project belongs to: the developer bottleneck with JEPA models today, the missing toolchain layers, the three planned tools of which jepa-scope is the first, the compute strategy, Week 1 progress and lessons, the candidates for the next milestone, and open risks. Signed-off-by: RDCLder <raymondyang.dev@gmail.com>
Adopt the workflow kit from github.com/ryangswe/claude-workflow at the full level: planner, architect, executor, reviewer and Explore agents; checkpoint, handoff and parallel-work skills; a guard against edits on main; plans in docs/plans/; and a decisions record checked by .claude/workflow/check.py. CLAUDE.md describes the project, its commands, shared contracts and rules. The decisions record captures the choices already made about the surprise method, windowing, the cache, the .latent format, licensing, project order and CI. CI gains a workflow-check job, and the README links the roadmap and decisions. Signed-off-by: RDCLder <raymondyang.dev@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Until now, the plan behind this project lived only in the conversation that produced it. This PR writes it down and sets up the written workflow used to build it.
Roadmap (
docs/roadmap.md). It covers why the project exists, what breaks today when a developer tries to use V-JEPA 2 oreb_jepa, the missing toolchain layers, the three planned tools (jepa-scope first, then jepa-probe and latent-plan, whose order is still a proposal), the compute strategy, Week 1 progress and what it taught, the candidates for the next milestone, and open risks.Workflow kit (full level). This adds a committed
.claude/with planner, architect, executor, reviewer and Explore agents, plus checkpoint, handoff and parallel-work skills and a guard against edits onmain. Plans go indocs/plans/, andCLAUDE.mddescribes the project's layout, commands, shared contracts and rules. No plan file is included yet, because the next milestone has not been chosen.Decisions record (
docs/decisions.md). It records the choices already made and why: how surprise is computed and why the obvious alternatives fail, the windowing, the cache's output version, the.latentformat, licensing, project order and the CI install strategy.CI. A new job runs
.claude/workflow/check.py, which checks the CLAUDE.md size budget, the decisions format and the plans list.