gsd-guide

GSD tutorial, command reference, and workflow explainer. Explains what a GSD workflow command does before you run it. Activates when user is new to GSD, asks about commands, wants to understand workflows, or mentions preview.

الانتقال إلى التثبيت

المستودع: Tibsfox/gsd-skill-creator
آخر نشاط في المصدر: ٧ يوليو ٢٠٢٦ في ٠٤:١٩
لغة SKILL.md المكتشفة: الإنجليزية
النجوم: ٦٩
التفرعات: ٩

خيارات التثبيت

يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.

npx skills add https://github.com/Tibsfox/gsd-skill-creator --skill gsd-guide

يبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.

تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.

مراجعة ملفات المصدر

اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.

SKILL.md

تعليمات المصدر · معاينة للقراءة فقط

العودة إلى البحث العودة إلى التثبيت

goal-ambiguity-gate

Use the moment a request is underspecified and you are about to act on an ASSUMED goal. Enumerate the candidate goals the request could mean, project the action or artifact each one implies, and check whether they diverge: if two or more plausible goals lead to materially different actions or artifacts, ask exactly ONE targeted clarifying question; otherwise proceed on the most-likely goal and state the assumption in one line. Clarification is an evidence-producing action, not a delay — but one question, never an interrogation. Distinct from gsd-spec-phase (GSD-phase-bound, emits a heavy SPEC.md) and intent-router (fetch strategy, not goal disambiguation). Backed by agent goal-state inference (arxiv 2606.16813v1). Triggers on acting under an assumed goal when the request admits more than one materially different reading.

2026-07-19

memory-hubness-gate

Use at write time to vector/embedding memory — Grove content-addressed insertion, chroma/pgvector upserts, memory-consolidation promoting session traces to MEMORY.md, or embedding externally-ingested content. Scores each candidate record against a fixed panel of sentinel queries and quarantines any record that would become the nearest neighbor of too many unrelated queries — a hub — whether from adversarial poisoning or accidental over-generality. This is the memory-record-side sibling of skill-injection-guardian (file-side) and the write-side complement of memory-use-warrant (read-side). Quarantine, never silently drop; a human reviews. Backed by the admission-time hubness gate (arxiv 2606.19692v1). Triggers on inserting into vector memory, consolidating memory, and embedding stranger content.

2026-07-19

memory-use-warrant

Run this appropriateness check the moment you are about to integrate a retrieved long-term memory — a Grove content-addressed hit, a chroma/pgvector neighbour, a memory-consolidation digest, or a MEMORY.md line — into a response, especially anything touching private origins, Fox Companies IP, credentials, or Center Camp / consent-governed content. It answers a question intent-router never asks: not WHAT to fetch or HOW, but WHETHER a correctly-retrieved item should reach output. Relevance is not appropriateness — a perfect similarity match can still be a boundary violation. Default is FAIL-CLOSED: if in-context authorization is uncertain, the memory may inform behaviour but must not be surfaced. Backed by RBI-Eval (arxiv 2606.06055v1). Triggers on surfacing recalled sensitive memory into a response.

2026-07-19

عرض الكل من هذا المستودع

.planning/
├── PROJECT.md       # Vision, decisions
├── REQUIREMENTS.md  # REQ-IDs
├── ROADMAP.md       # Phases
├── STATE.md         # Current position
├── config.json      # Settings
├── phases/NN-name/  # Plans + summaries
└── milestones/      # Archives

Command	Purpose
/gsd:new-project	Init project
/gsd:new-milestone	New version
/gsd:progress	State + next action
/gsd:discuss-phase N	Gather context
/gsd:plan-phase N	Create plans
/gsd:execute-phase N	Build plans
/gsd:quick	Small tasks
/gsd:verify-work N	Test deliverables
/gsd:audit-milestone	Completion check
/gsd:complete-milestone	Archive
/gsd:debug	Debug with state
/gsd:pause-work	Checkpoint
/gsd:resume-work	Restore

plan-phase N → /clear → execute-phase N → verify-work N

## /gsd:command-name - [Purpose]

**What it does:**
[2-3 sentence overview]

**Process:**
1. [First step - what happens]
2. [Second step - what happens]
3. [Third step - what happens]

**Files created/modified:**
- `.planning/path/to/file.md` - [purpose]
- `.planning/other/file.json` - [purpose]

**Agents spawned:**
- `agent-name` (model) - [what it does]

**User interaction:**
- [Number] prompts expected
- [Type of input needed]

**Estimated:**
- Time: [duration estimate]
- Context: [percentage of window]

**After completion:**
- [What state the project will be in]
- [Next recommended command]

.planning/
├── PROJECT.md           # Vision, requirements, decisions
├── REQUIREMENTS.md      # What we're building (REQ-IDs)
├── ROADMAP.md           # Phase structure and status
├── STATE.md             # Session memory, current position
├── config.json          # Workflow preferences
│
├── phases/
│   ├── 01-foundation/
│   │   ├── 01-CONTEXT.md      # User vision for phase
│   │   ├── 01-RESEARCH.md     # Optional research findings
│   │   ├── 01-01-PLAN.md      # Executable plan
│   │   └── 01-01-SUMMARY.md   # What was built
│   │
│   └── 02-features/
│       └── [same structure]
│
└── milestones/
    └── v1.0-ROADMAP.md        # Archived completed milestones

Agent Type	Purpose	Spawned By
`gsd-project-researcher`	Research domain before roadmap	/gsd:new-project
`gsd-research-synthesizer`	Synthesize parallel research	/gsd:new-project
`gsd-roadmapper`	Create project roadmap	/gsd:new-project
`gsd-phase-researcher`	Research implementation approach	/gsd:plan-phase, /gsd:research-phase
`gsd-planner`	Create executable plans	/gsd:plan-phase
`gsd-plan-checker`	Verify plans match goals	/gsd:plan-phase
`gsd-executor`	Execute plans with atomic commits	/gsd:execute-phase, /gsd:quick
`gsd-verifier`	Test phase deliverables	/gsd:verify-work
`gsd-debugger`	Systematic debugging	/gsd:debug
`gsd-integration-checker`	Cross-phase integration tests	/gsd:audit-milestone

## /gsd:plan-phase 3 - Create Executable Plans for Phase 3

**What it does:**
Reads Phase 3 from your ROADMAP.md and creates detailed, executable
PLAN.md files that break the phase goal into atomic tasks with
verification criteria.

**Process:**
1. Reads Phase 3 details from .planning/ROADMAP.md
2. Checks for .planning/phases/03-name/03-CONTEXT.md (optional)
3. Spawns gsd-phase-researcher if research enabled in config
4. Spawns gsd-planner to create PLAN.md files
5. Spawns gsd-plan-checker to verify plans achieve phase goal
6. Commits plans to git

**Files created:**
- `.planning/phases/03-name/03-RESEARCH.md` (if research enabled)
- `.planning/phases/03-name/03-01-PLAN.md` (first plan)
- `.planning/phases/03-name/03-02-PLAN.md` (additional plans)

**Agents spawned:**
- gsd-phase-researcher (Opus) - Optional, researches implementation
- gsd-planner (Opus/Sonnet) - Creates executable plans
- gsd-plan-checker (Opus) - Verifies plans match phase goals

**User interaction:**
- 0-2 prompts (only if plan checker finds issues)

**Estimated:**
- Time: 3-8 minutes (longer if research enabled)
- Context: ~30-40% of window

**After completion:**
- Phase 3 plans ready in .planning/phases/03-name/
- Ready to run /gsd:execute-phase 3

name	gsd-guide
description	GSD tutorial, command reference, and workflow explainer. Explains what a GSD workflow command does before you run it. Activates when user is new to GSD, asks about commands, wants to understand workflows, or mentions preview.
format	"2025-10-02T00:00:00.000Z"
version	1.0.0
status	ACTIVE
updated	"2026-04-15T00:00:00.000Z"
triggers	["user is new to GSD, asks about commands, wants to understand workflows, or mentions preview"]

name	gsd-guide
description	GSD tutorial, command reference, and workflow explainer. Explains what a GSD workflow command does before you run it. Activates when user is new to GSD, asks about commands, wants to understand workflows, or mentions preview.
format	"2025-10-02T00:00:00.000Z"
version	1.0.0
status	ACTIVE
updated	"2026-04-15T00:00:00.000Z"
triggers	["user is new to GSD, asks about commands, wants to understand workflows, or mentions preview"]

gsd-guide

خيارات التثبيت

مراجعة ملفات المصدر

GSD Guide — Quick Reference + Workflow Explainer

GSD Guide — Quick Reference + Workflow Explainer

Section 1 — Quick Reference

Files

Commands

Workflow

Concepts

Section 2 — Detailed Explanations

When to Use

What This Skill Does

Explanation Template

Key Workflows to Explain

Initialization Workflows

Planning Workflows

Execution Workflows

Validation Workflows

File Structure Reference

Agent Type Reference

Common User Questions

Example Explanation

Tips for Better Explanations

Integration with GSD

gsd-guide

معلومات المصدر

خيارات التثبيت

مراجعة ملفات المصدر

المزيد من هذا المستودع

المزيد من هذا المستودع

GSD Guide — Quick Reference + Workflow Explainer

GSD Guide — Quick Reference + Workflow Explainer

Section 1 — Quick Reference

Files

Commands

Workflow

Concepts

Section 2 — Detailed Explanations

When to Use

What This Skill Does

Explanation Template

Key Workflows to Explain

Initialization Workflows

Planning Workflows

Execution Workflows

Validation Workflows

File Structure Reference

Agent Type Reference

Common User Questions

Example Explanation

Tips for Better Explanations

Integration with GSD