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.