
Bootstrap phase context for Overseer. Provides phase under review with full file contents and card metadata.
# Create Card Create a new Hieroglyphs-compatible card to track work items, bugs, or features. Cards use the Hieroglyphs format with YAML frontmatter and markdown body, stored in `.ushabti/cards/{slug}/card.md` directories. ## When to Use Create a card when: - Discovering technical debt that should be tracked - Identifying a bug or issue that should be addressed later - Capturing a feature request or improvement idea - Recording any work item that should be tracked separately from the current
Create a phase directory with all required files in one call. Use instead of separate mkdir + Write calls when creating a new phase.
Plan-Build-Review cycle and agent handoffs. Load when transitioning between agents or understanding workflow progression.
Mandatory files agents must read before acting. Load when starting agent work to ensure prerequisites are met.
Step format and ordering rules for steps.md. Load when defining implementation steps or checking step requirements.
Get the laws and style for the current project.
Query the status of a phase. Returns structured status information for external consumers.
Phase sizing, scope boundaries, and anti-patterns. Load when evaluating whether a phase is well-formed or needs splitting.
Agent responsibilities and hard boundaries. Load when determining which agent should act or checking role violations.
File locations for laws, style, phases, and docs. Load when locating or creating Ushabti state files.
Phase directory layout, naming conventions, and required files. Load when creating or navigating phase directories.
Structure and field ownership for progress.yaml. Load when reading or updating phase progress state.
Structure and sections for review.md. Load when creating review scaffolds or recording review findings.
Core Ushabti concepts and development lifecycle. Load when starting any Ushabti workflow or orienting to the framework.
Determine the next sequential phase ID for creating a new phase. Use when planning a new phase.
Find the next unimplemented step in a phase. Use when determining what to work on next.
Check the current status of a phase. Use when you need to understand where a phase is in the workflow.
Mark a step as implemented in progress.yaml with notes and touched files. Use after completing each step instead of manual Edit calls.
Verify required Ushabti files exist before proceeding. Use when starting agent work to ensure prerequisites are met.
Approve a phase — sets status to complete, marks all steps reviewed, updates linked card. Use when declaring a phase green.
Bootstrap phase context for Builder. Provides current phase, next step, and full phase file contents.
# Complete Card Mark a card as done by updating its status field to `done` and setting the updated timestamp. This replaces the old ticket archival system where tickets were moved to an `.archived/` directory. ## When to Use Mark a card complete when: - A Phase addressing the card's work has been completed and reviewed - The work item has been fully implemented and verified - The Overseer determines the card's requirements are satisfied ## Status Update Cards track their lifecycle state in
# Describe Cards Comprehensive documentation of Ushabti's card system—the Hieroglyphs-compatible format for tracking work items, bugs, and features. ## Overview Ushabti uses Hieroglyphs-compatible cards to track work outside the current Phase. Cards replace the previous ticket system, providing alignment with the Hieroglyphs task management tool. Cards are stored as individual directories containing a `card.md` file with YAML frontmatter and markdown body. Unlike the old ticket system (flat
Documentation system location and maintenance requirements. Load when consulting or updating project documentation.
Distinction between laws (invariants) and style (conventions). Load when determining if a constraint is a law or style.
Required sections and format for phase.md. Load when defining phase intent, scope, and acceptance criteria.
Guidelines for asking clarifying questions. Load when deciding whether and how to ask the user for clarification.
Find the active phase directory based on status. Use when you need to locate which phase to work on.
Execute a full Scribe → Builder → Overseer phase cycle. Use when you have a PHASE_PROMPT and want to plan, build, and review a phase end-to-end.
Kick a phase back to building — sets status and adds new step entries to progress.yaml. Use when requesting fixes from Builder.
# List Cards Scan and list all Hieroglyphs-compatible cards in `.ushabti/cards/`, with optional filtering by status or other criteria. ## When to Use Use this skill when: - You need to see all available work items - Looking for cards in a specific state (e.g., only `todo` cards) - Determining which cards to plan next - Checking card priorities and types ## Card Location Cards are stored in: ``` .ushabti/cards/{slug}/card.md ``` Each card is a directory containing a `card.md` file with YAML
Set the status field in a phase's progress.yaml. Use instead of manual Edit calls when transitioning phase status.