Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.joggr.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

/gg-new starts a new Workflows project. It prompts for a description, derives a project slug, and scaffolds all the files Workflows needs to take your idea through discussion, research, planning, execution, and verification.

​
Invocation

/gg-new [description]
If you provide a description, Workflows uses it directly. If you run /gg-new with no arguments, Workflows prompts you to describe what you want to build.

​
What It Produces

A new project directory at .joggr/.gg/projects/{slug}/ containing:
  • input.md — your description, extracted goals, constraints, and links
  • discussion.md — stub for the discuss step
  • research.md — stub for the research step
  • plan.md — stub for the plan step
  • phases/ — empty directory for phase files created during planning
Workflows sets this project as the active project so subsequent commands target it automatically.

​
Behavior

  • Slug validation — slugs must be lowercase alphanumeric with hyphens only (e.g., auth-refactor, webhook-endpoint). Workflows rejects invalid characters.
  • Existing projects — if a project with the same slug already exists, Workflows asks whether to overwrite it, resume it, or choose a different slug.
  • Checkpoint — after scaffolding, Workflows offers to commit and push the new project files. You can skip this and commit manually later.
Include as much context as possible in your description — requirements, constraints, links to specs or designs. This context feeds directly into /gg-research and /gg-plan, producing better results with less back-and-forth.