Add gitagent format support (agent.yaml, SOUL.md, RULES.md, DUTIES.md)#357
Open
shreyas-lyzr wants to merge 1 commit intogarrytan:mainfrom
Open
Add gitagent format support (agent.yaml, SOUL.md, RULES.md, DUTIES.md)#357shreyas-lyzr wants to merge 1 commit intogarrytan:mainfrom
shreyas-lyzr wants to merge 1 commit intogarrytan:mainfrom
Conversation
Add gitagent-standard metadata files so gstack is also a valid gitagent agent. This is additive — all existing gstack functionality is unchanged. New files: - agent.yaml — gitagent manifest (name, version, skills, model, tags) - SOUL.md — builder philosophy extracted from ETHOS.md - RULES.md — development rules extracted from CLAUDE.md - DUTIES.md — sprint workflow (think → plan → build → review → test → ship → reflect) - hooks/hooks.yaml — safety hooks (freeze check, careful mode) - skills/ — gitagent-compatible SKILL.md wrappers for all 27 skills Validates cleanly with `gitagent validate` and works with all gitagent export adapters (claude-code, openai, cursor, copilot, opencode, etc.)
6d84fdb to
d0ea488
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
skills/directoryWhat is gitagent?
gitagent is a framework-agnostic, git-native standard for defining AI coding agents. It lets agent configs be exported to any platform — Claude Code, Cursor, Copilot, OpenAI, Codex, Gemini CLI, and more — from a single source of truth.
gstack is a perfect fit: it's already Markdown-first, skill-based, and git-native. This PR makes that compatibility explicit.
New files
agent.yamlSOUL.mdRULES.mdDUTIES.mdhooks/hooks.yamlskills/*/SKILL.mdValidation
What this enables
With gitagent format, gstack can be:
gitagent export -f cursor,gitagent export -f copilot,gitagent export -f opencode, etc.gitagent validategitagent diffTest plan
gitagent validatepasses cleanlygitagent infoshows all 27 skills./setupand skill invocation unchanged