tour

Solid

Interactive onboarding walkthrough for a new engineer. Use for "give me a tour", "onboard me", "walk me through the codebase".

Code & Development 40 stars 6 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
54
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Draft Tour: Interactive Onboarding Provide an interactive codebase walk-through based on existing architecture and guardrail constraints. ## Red Flags - STOP if you're: - Dumping the entire `architecture.md` into the chat window. - Giving answers to foundational pattern questions before prompting the developer to guess. - Explaining code the developer hasn't explicitly asked to view yet. --- ## Execution Constraints 1. **Load Context:** Read `draft/architecture.md`, `draft/tech-stack.md`, and `draft/guardrails.md`. 2. **Interactive Cadence:** Ask the developer if they are familiar with the tech stack constraints found in `draft/tech-stack.md`. 3. **Module Introduction:** Instead of listing all modules, introduce the "Entry Point" module first. 4. **Active Challenge:** After explaining a module's responsibility, challenge the developer: "Based on our *Context-Driven Development* rules, how do you think we handle data persistence here?" Wait for their answer before revealing the architecture strategy. - If the answer is correct, confirm briefly and cite the supporting line in `architecture.md` / `guardrails.md`. - If the answer is partially right, name what they got right, then ask a narrower follow-up (e.g., "Right that we cache reads — what's the invalidation trigger?") before revealing the rest. - If the answer is wrong, do not just hand them the answer. Quote the specific guardrail or HLD section that contradicts it, then re-prompt with a hint scoped to that...

Details

Author
drafthq
Repository
drafthq/draft
Created
7 months ago
Last Updated
2 days ago
Language
HTML
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

guided-tour

Run a live, interactive guided tour of a codebase — you act as a hands-on tutor who leads the user through how the code actually works, one digestible piece at a time, pausing often so they can ask questions, go deeper, or redirect. This is a real-time conversation, NOT a document or HTML file you generate and hand off. Diagrams are used freely (ASCII, Mermaid, or rich widgets) wherever they make a concept click. TRIGGER this skill whenever the user wants to UNDERSTAND a codebase through conversation rather than receive a static artifact. Match phrases like: - "give me a guided tour", "walk me through this codebase interactively", "onboard me to this project", "teach me how this works", "help me understand this repo" - "explain how X works and let me ask questions", "I want to explore how X is built" - "I'm new to this codebase, where do I start", "trace how a request flows and stop so I can follow", "be my tour guide for this code" Also trigger when someone drops into an unfamiliar repo and expresses confusi

1 Updated 1 weeks ago
jonascript
Web & Frontend Listed

toutour

Add a spotlight onboarding tour to any website. Analyzes the site's layout, tabs and UI components, interviews the developer (step granularity, mask, languages, theming, trigger mode, library), then generates and Playwright-verifies a guided tour. Use when the user asks for an onboarding tour, product tour, guided walkthrough, coach marks, feature introduction overlay, or says users can't figure out their site.

3 Updated 2 weeks ago
matt-ye
AI & Automation Listed

architecture-and-decisions

Create an architecture and decision walkthrough that explains how a software project fits together and WHY each significant choice was made, with the alternatives, the trade-offs, and the failure modes. Takes a reader from "can use it" to "understands it well enough to change or extend it safely." Produces Markdown (repo-first) with C4-style diagrams and a decision treatment for every important choice. Use this whenever the user wants an architecture doc, design doc, technical deep-dive, decision record narrative, "why is it built this way", or to understand the system in depth. Use it even if the user only says "document the architecture and the reasoning", "explain the design decisions", or "write the technical overview for a new engineer". For one technical reader who can already use the system — NOT a newcomer course (use learning-track), NOT operator recovery steps (use operations-runbook), NOT a look-up Q&A page (use project-faq).

0 Updated 4 days ago
imrohitagrawal