Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
58bb5bc
feat(packages/ui): add MDX content components for doc-platform parity
zrosenbauer Apr 10, 2026
b50e911
docs(repo): register new built-in components in sidebar navigation
zrosenbauer Apr 10, 2026
8c6ed6a
fix(docs): use quad-backtick fences to avoid nested code block conflicts
zrosenbauer Apr 10, 2026
b2166f1
fix(packages/ui): reduce accordion panel padding and center trigger
zrosenbauer Apr 10, 2026
a50ca9e
refactor(packages/ui): rename StatusBadge to Badge, redesign Prompt c…
zrosenbauer Apr 10, 2026
579554d
refactor(packages/ui): simplify Badge to standard variants with custo…
zrosenbauer Apr 10, 2026
aebb15c
docs(repo): reorder built-ins sidebar by logical grouping
zrosenbauer Apr 10, 2026
2a73b1e
feat(packages/config,packages/core): add sort 'none' to preserve conf…
zrosenbauer Apr 10, 2026
243311f
refactor(packages/ui): redesign Prompt with description, actions, and…
zrosenbauer Apr 10, 2026
a3aba3b
refactor(packages/ui): add full action buttons and dropdown to Prompt…
zrosenbauer Apr 10, 2026
a413812
fix(packages/ui): use deeplinks for Cursor/VS Code and pre-fill for C…
zrosenbauer Apr 10, 2026
a39349f
docs(built-ins): add richer markdown examples to Prompt documentation
zrosenbauer Apr 10, 2026
a0d78bd
fix(docs): use template literals for Prompt children to avoid MDX par…
zrosenbauer Apr 10, 2026
8f4b1b8
fix(packages/ui): force code block styling on Prompt expanded view
zrosenbauer Apr 10, 2026
e90cf89
refactor(packages/ui): use CodeBlockRuntime and icon libs for Prompt
zrosenbauer Apr 10, 2026
1b715c9
fix(packages/ui): fix accordion alignment, hover, and border radius
zrosenbauer Apr 10, 2026
94a7c37
fix(packages/ui): fix accordion chevron vertical alignment
zrosenbauer Apr 10, 2026
97c869e
refactor(packages/ui): replace custom chevron SVG with Icon, add min-…
zrosenbauer Apr 10, 2026
de51e49
Merge branch 'main' into feat/mdx-content-components
zrosenbauer Apr 10, 2026
300b94b
fix(packages/ui): address PR review feedback
zrosenbauer Apr 10, 2026
32debda
fix(packages/ui): use .then().catch() pattern for clipboard promises
zrosenbauer Apr 10, 2026
6bc8d01
feat(packages/ui): add Field, FieldGroup, Steps, and Step components
zrosenbauer Apr 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/add-mdx-content-components.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@zpress/ui': minor
---

Add MDX content components for doc-platform parity: Accordion, AccordionGroup, Columns, Column, StatusBadge, Frame, Tooltip, Prompt, and Color. Reorganize theme barrel with public API sections and @internal annotations on framework exports.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# Dependencies
node_modules/

# Superpowers brainstorm sessions
.superpowers/

# Build output
dist/
*.tsbuildinfo
Expand Down
2 changes: 2 additions & 0 deletions .joggr/.gg/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
state.json
settings.local.json
104 changes: 104 additions & 0 deletions .joggr/.gg/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
<!-- Auto-synced from plugin. Do not edit manually. -->

# .joggr/.gg/

A structured workflow system for managing development projects through a phased pipeline.

## Workflow Pipeline

```
/gg-new → /gg-discuss → /gg-research → /gg-plan → /gg-execute → /gg-verify
```

Each step advances the workflow. `.joggr/.gg/state.json` tracks only the active project. Phase status is tracked in phase file YAML frontmatter.

## Skills

Skills are slash commands that drive the workflow. Each skill manages state transitions, user interaction, and agent orchestration.

| Skill | Description |
| ------------- | --------------------------------------------------------------------------------------------------------------- |
| `gg-new` | Scaffold a project from a Linear issue/project or free-text description |
| `gg-status` | Read-only tree view of project progress |
| `gg-discuss` | Interview user to gather requirements (goals, constraints, preferences, edge cases, acceptance criteria) |
| `gg-research` | Spawn background agent to explore codebase and web for technical context |
| `gg-plan` | Create phase plan with tasks, file targets, acceptance criteria, and dependencies |
| `gg-execute` | Group tasks into parallel waves and spawn executor agents |
| `gg-verify` | Spawn verifier agent to check acceptance criteria with concrete evidence |
| `gg-codebase` | Analyze repo and maintain `.joggr/.gg/codebase/` docs (stack, architecture, conventions, testing, integrations) |
| `gg-help` | Display all available commands and usage |

## Agents

Agents are subagents spawned by skills to do the actual work.

| Agent | Interactive? | Description |
| --------------------- | --------------- | ----------------------------------------------------------------------------------------------------- |
| `researcher` | No (background) | Codebase + web researcher — explores code, maps dependencies, finds existing patterns |
| `planner` | Yes | Task decomposer — breaks phases into tasks with file targets and acceptance criteria |
| `executor` | No (background) | Task implementer — executes one task, validates with typecheck/lint/test |
| `verifier` | No (background) | Acceptance verifier — checks every criterion with concrete evidence |
| `codebase-researcher` | No (background) | Codebase analyst — explores repo with Serena MCP tools, writes focused docs to `.joggr/.gg/codebase/` |

## Docs

Internal documentation for agent authors.

| File | Purpose |
| ----------------------------- | --------------------------------------------------------------------- |
| `docs/core/architecture.md` | Overview, definitions, component interaction diagram |
| `docs/core/state.md` | State tracking, workflow artifacts, session persistence |
| `docs/standards/interface.md` | How skills pass context to agents and how agents return results |
| `docs/standards/agent.md` | Agent file structure, required/optional sections, example skeleton |
| `docs/standards/skill.md` | Skill file structure, common patterns, example skeleton |
| `docs/guides/linear.md` | Linear integration — ingestion, data flow, outcome vs. implementation |
| `docs/core/principles.md` | Behavioral principles for building skills and agents |

## Troubleshooting

If GG is behaving unexpectedly, see `TROUBLESHOOTING.md` in this directory for common failure modes and recovery steps.

## Templates

Templates scaffolded by `gg-new` into `.joggr/.gg/projects/{project-slug}/`.

| File | Purpose |
| -------------------------- | ----------------------------------------------------- |
| `input.md` | Raw requirements and user intent |
| `discussion.md` | Timestamped interview log |
| `research.md` | Technical research findings |
| `overview.md` | Project overview and phase breakdown |
| `plan.md` | Project-level plan with phase/task XML |
| `phase.md` | Per-phase task plan with XML format |
| `codebase/stack.md` | Technology stack reference template |
| `codebase/architecture.md` | Architecture and structure reference template |
| `codebase/conventions.md` | Code conventions and style reference template |
| `codebase/testing.md` | Testing patterns and framework reference template |
| `codebase/integrations.md` | External integrations and services reference template |

## Runtime Directory

When a project is active, the working directory looks like:

```
.joggr/.gg/
├── state.json # Workflow state
├── settings.json # GG configuration
├── settings.local.json # Local overrides (gitignored)
├── codebase/ # Shared codebase documentation
│ ├── stack.md
│ ├── architecture.md
│ ├── conventions.md
│ ├── testing.md
│ └── integrations.md
└── projects/ # All project directories
└── {project-slug}/ # Per-project directory
├── input.md
├── discussion.md
├── research.md
├── overview.md
├── plan.md
└── phases/
└── <N>-<slug>/
└── phase.md # Per-phase task plans
```
Loading
Loading