Agent skill · software engineering · jeremylongshore
scaffold
Use when starting hyperflow in a new project, refreshing the .hyperflow/ cache, or installing auto-detection shims (AGENTS.md, CLAUDE.md). One-shot project setup; does not start the spec → scope → dispatch chain. Trigger with /hyperflow:scaffold, "init hyperflow", "set up hyperflow", "refresh hyperflow", "install hyperflow shims".
Why this skill is useful
Adds executable scripts for project setup and analysis that automate the initialization of the hyperflow environment, which the AI cannot generate from existing knowledge.
What it needs
Requires bash installed locally. About 6k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Scaffold One-shot project setup. Analyzes the codebase, builds the .hyperflow/ cache, seeds the memory skeleton, and optionally installs detection shims for other AI tools. Does not start the plan → dispatch chain — invoke /hyperflow:plan when you're ready for that. Step 1 — Analysis Cache Check for .hyperflow/ at project root. If absent — dispatch parallel searchers (single message, six Agent calls): Label File generated Discovers --- --- --- Searcher — analyzing tech stack profile.md Name, language, framework, build commands Searcher — mapping folder structure architecture.md Dirs, patterns, routing, data flow Searcher — extracting conventions conventions.md Naming, style, linting rules Searcher — scanning dependencies dependencies.md UI lib, state, data fetching, DB, auth Searcher — auditing test setup testing.md Runner, E2E, patterns, commands Searcher — reading git workflow git-workflow.md Branches, commits, CI/CD, PR conventions See project-analysis.md for what each file captures. If present — staleness check: Compute SHA256 of tracked config files, compare against .hyperflow/.checksums. Refresh only stale files. Print Refreshing — <comma-separated list of stale files>. After analysis: Write .hyperflow/.checksums (SHA256 of package.json, tsconfig.json, eslint/biome config, etc.) Write .hyperflow/.version (the current plugin version from skills/hyperflow/VERSION) so the cache is stamped current. The session-start migrator (scripts/migrate-cache.py) reads this marker on later sessions and brings an older cache forward when the plugin version moves — a missing/older marker triggers an idempotent, additive migration (new memory files, refreshed doctrine copy). Append to .gitignore if .hyperflow/ is not already excluded Step 2 — Memory Skeleton Create .hyperflow/memory/ if absent: session-context.md — populated by the session-start hook, not scaffold: Scaffold creates the empty .hyperflow/memory/ directory; it does NOT write session-context.md. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/scaffold