portal-git-workflow

Enforces branch naming, Conventional Commits, and PR workflows for a financial data portal project.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/ArthurZizumbo/karisma-data --skill portal-git-workflow-arthurzizumbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portal-git-workflow
Source: https://github.com/ArthurZizumbo/karisma-data/tree/main/.claude/skills/portal-git-workflow
Command: npx skills add https://github.com/ArthurZizumbo/karisma-data --skill portal-git-workflow-arthurzizumbo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams working on the Portal Centralizado de Datos Financieros need consistent Git discipline across epics and user stories: uniform branch names, scoped Conventional Commits, PRs targeting develop, and traceable user story closure. This Skill removes ambiguity and prevents mistakes like committing directly to main or opening PRs without a clean check. ## Core Features & Use Cases - Branch and commit conventions: Enforces feature/E{epic}-US-XXX-{slug} branch names and Conventional Commits with epic scopes (UX, E0–E5), with no AI co-author trailers or emojis. - PR and merge workflow: Guides the full cycle from branching off develop, running make check before opening a PR with gh, squash merging, and releasing to main which triggers Cloud Run deployment. - User story closure: Verifies acceptance criteria against the project plan and references absorbed user stories for backlog traceability. - Use Case: A developer finishing a JWT authentication user story creates branch feature/E2-US-XXX-jwt-rbac, commits with feat(E2) scopes, runs make check, and opens a PR to develop with verified acceptance criteria. ## Quick Start Ask the assistant to create a new feature branch and commit your changes for user story US-XXX following the portal Git workflow conventions.

Frequently Asked Questions about portal-git-workflow

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

FAQPage Schema
How do I name a feature branch for a user story?

Use the pattern feature/E{epic}-US-XXX-{slug}, where epic is one of UX, E0, E1, E2, E3, E4, or E5, XXX is the user story number from the project plan, and slug is a short description. Always branch from an updated develop.

How do I write Conventional Commits with an epic scope?

Prefix each commit with a type and epic scope, such as feat(E2): add user CRUD endpoints or fix(E3): cancel LLM call on disconnect. Valid types include feat, fix, docs, test, refactor, perf, chore, and ci, with no emojis or AI co-author trailers.

Should pull requests target main or develop?

All feature PRs target develop, never main directly. Merging to main triggers the deployment pipeline to Cloud Run, so it is reserved for release PRs from develop when the team decides to deploy.

What checks must pass before opening a pull request?

Run make check and make test locally and ensure they pass cleanly before pushing and opening the PR with gh pr create. CI must also be green before the PR is squash merged.

How do I close a user story after merging?

Verify each acceptance criterion against the project plan, reference any absorbed user stories from the consolidated backlog in the PR, document any agreed degradations, and mark the story complete in team tracking.