status

Displays Circle framework status, workflow phase, and artifacts for the current project.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/alessioroberto82/claude-plugin-circle --skill status-alessioroberto82
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: status
Source: https://github.com/alessioroberto82/claude-plugin-circle/tree/main/plugins/circle/skills/status
Command: npx skills add https://github.com/alessioroberto82/claude-plugin-circle --skill status-alessioroberto82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working across multiple AI-assisted roles and workflows, it is hard to know what has been done, what phase the project is in, and what to do next. This Skill gives you an instant dashboard of the Circle framework state for your current project. ## Core Features & Use Cases - Project Detection: Automatically detects the project name and domain (software, business, personal, or general) by scanning for marker files like package.json, go.mod, or business-plan.md. - Workflow Status: Reads session-state.json to show the current phase, active workflow, and completed steps, plus lists generated artifacts per role. - Detailed View: On request, shows TDD configuration, integration availability (Linear, Notion, no-mistakes), and the local Circle plugin version. - Use Case: After returning to a project mid-way, run the status command to see that requirements and architecture are done and that QA is the suggested next step. ## Quick Start Ask the assistant to show the Circle status dashboard for this project, optionally requesting the detailed view.

Frequently Asked Questions about status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the status of my Circle project?

Invoke the status command in your project directory. It detects the project name from the current folder, reads the session-state file under ~/.circle/projects, and shows the current phase, completed steps, and suggested next action.

How does Circle status detect my project domain?

It scans the current directory for marker files: package.json, go.mod, or Cargo.toml indicate software; business-plan.md or strategy.md indicate business; goals.md or a habits folder indicate personal. If nothing matches, it defaults to general.

What does the detailed status view show?

The detailed view lists generated artifacts per role directory, active workflow details, TDD configuration from config.yaml, and integration availability for Linear, Notion, and no-mistakes, plus the local Circle plugin version.

Why does Circle status say my project is not initialized?

This happens when no session-state.json exists under ~/.circle/projects for your project name, meaning no Circle workflow has run yet. Run circle:init or circle:greenfield to initialize the project and start tracking state.

Can Circle status connect integrations automatically?

No. The status view only reports whether integrations like Linear or Notion are connected, available, or unavailable. Connecting or installing integrations requires explicit user confirmation and is never done automatically.