SkillsAdd

ttttstc/vibeflow · Archived

vibeflow-reverse-spec

Refreshes docs/overview architecture context for an existing codebase (Python + TypeScript)

First seen Jun 22, 2026

Installation

$ npx skills add ttttstc/vibeflow --skill vibeflow-reverse-spec
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

vibeflow-status Same source
ttttstc/vibeflow

查看 VibeFlow 项目当前状态（阶段、进度、?

1 installs
vibeflow-router Same source
ttttstc/vibeflow

在此仓库中用于在会话开始时路由整个VibeFlow生命周期的工作。

1 installs
skill-safety-verifier Same author
ttttstc/skill-safety-verifier

Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitH…

39 installs

Also in this package

Other skills from ttttstc/vibeflow.

npx skills add ttttstc/vibeflow
vibeflow-status 1 vibeflow-router 1

Browse all from ttttstc/vibeflow

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 11
License MIT
Default branch main
Open issues 17
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,502 B
  • docs SUMMARY.md 120 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Reverse-Generated Overview Context

[VibeFlow skill for automatic architecture documentation generation]

Goal

Refresh the current docs/overview/ context for an existing codebase so new contributors can immediately understand:

  • current module layout
  • key entry points
  • current change focus
  • risks and suggested reading order
  • deep architecture context rendered in ARCHITECTURE.md (Arc42 + C4 + inferred runtime/module view)

Trigger

  • Explicit: /vibeflow-reverse-spec
  • Auto-trigger: VibeFlow detects non-empty project with missing or stale docs/overview/ARCHITECTURE.md

Prerequisites

  • Project must contain Python (.py) or TypeScript (.ts/.tsx/.js/.jsx) source files
  • Non-empty project (at least 1 module detected)

Execution Flow

Step 1: Refresh project and architecture overview

Run: python scripts/map-codebase.py --project-root {project_root} --refresh force
Output: docs/overview/PROJECT.md + docs/overview/ARCHITECTURE.md

说明：

  • ARCHITECTURE.md 内会统一包含 spec_analyzer 的结果
  • 不再额外依赖 .vibeflow/analysis/ 下过程文件
  • 需要更高保真的职责/运行流时，应把 LLM 推断直接补充进 ARCHITECTURE.md 的 Arc42 生成区块

Step 2: Refresh current change focus

Run: python scripts/map-change-impact.py --project-root {project_root} --source design
Output: docs/overview/CURRENT-STATE.md

Step 3: Verify output

  • Check docs/overview/PROJECT.md exists
  • Check docs/overview/ARCHITECTURE.md exists
  • Check docs/overview/CURRENT-STATE.md exists
  • Confirm CURRENT-STATE.md includes current change focus and overview sync status

Output

  • docs/overview/PROJECT.md — long-lived project context
  • docs/overview/ARCHITECTURE.md — long-lived architecture context with Arc42 / C4 / inferred runtime view
  • docs/overview/CURRENT-STATE.md — current change focus and sync status
  • .vibeflow/wiki-status.json — freshness tracking

Quality Gate

  • Module graph must have > 0 nodes
  • If 0 modules detected → exit with error: "No source modules detected. Ensure this is a non-empty project with Python or TypeScript source files."

Integration

  • This skill is a pre-Design step
  • If overview docs are already fresh → silently succeed
  • Design phase should read docs/overview/PROJECT.md and docs/overview/ARCHITECTURE.md