context-resolution

Resolve project workflow context and git push targets from repository configuration files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Kiwi-Home/ai-workflow --skill context-resolution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: context-resolution
Source: https://github.com/Kiwi-Home/ai-workflow/tree/main/plugins/structured-workflows/skills/context-resolution
Command: npx skills add https://github.com/Kiwi-Home/ai-workflow --skill context-resolution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a single, deterministic protocol to discover and validate a project's workflow context so commands reliably know project identity, push targets, and artifact tracking before taking action.

Core Features & Use Cases

  • Canonical context resolution: Read and validate .claude/workflow.yaml fields such as project.name, project.domain, and project.template.
  • Bootstrap support: Handle first-run setup when workflow.yaml is missing by enumerating git remotes and pre-parsing candidate org/repo pairs.
  • Push target derivation & safety: Derive push_org/push_repo from configured remotes, warn on non-GitHub remotes, and lock the session target to prevent accidental cross-target operations.
  • Brief and tracking integration: Resolve briefs from GitHub issues or local files and map brief lifecycle statuses to GitHub labels when tracking is enabled.

Quick Start

Resolve the project's workflow context by reading .claude/workflow.yaml or running bootstrap detection to derive project identity and push targets.

Frequently Asked Questions about context-resolution

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

FAQPage Schema
How do I validate git push targets and project context from workflow.yaml?▼

Git push targets and project context are validated by reading .claude/workflow.yaml fields like project.name and project.template, then parsing git remotes to derive push_org and push_repo with enforced target safety and clear errors.

What happens during initial git bootstrap setup when workflow.yaml is missing?▼

During initial git bootstrap setup, the system enumerates git remotes to pre-parse candidate org/repo pairs, allowing first-run configuration to proceed by deriving project identity directly from repository remote URLs.

How do GitHub and local brief tracking work with workflow configuration?▼

GitHub and local brief tracking resolves briefs from GitHub issues or local files and maps brief lifecycle statuses to GitHub labels when tracking is enabled in the project configuration.

Can I use non-GitHub remote URLs for push target derivation?▼

Non-GitHub remote URLs are supported for push target derivation but trigger warnings, as the system normalizes GitHub and SSH remote URLs to enforce target safety and prevent accidental cross-target operations.

Why does my structured-workflows command fail to resolve project identity?▼

Structured-workflows commands fail to resolve project identity when required .claude/workflow.yaml fields such as project.name, project.domain, or project.template are missing or invalid, producing clear validation errors.

Does context resolution prevent accidental cross-target git operations?▼

Context resolution prevents accidental cross-target git operations by locking the session target after deriving push_org and push_repo from configured remotes, ensuring commands only execute against the validated target.