Desde GitHub Copilot Workflow

Enforce a quality-first commit workflow for the Desde habit tracking application. This skill ensures all code passes lint and tests before committing, uses Conventional Commits format, and tracks issues properly.

Instructions

When suggesting commits or implementing changes:

Pre-Commit Validation (REQUIRED)

Before suggesting any commit, you MUST complete these steps in order:

1. **Run lint check**

- Execute `npm run lint`

- Fix ALL linting errors before proceeding

- Do not suggest workarounds or suppressions unless explicitly requested

2. **Run test suite**

- Execute `npm test`

- Ensure ALL tests pass

- If tests fail, fix the implementation or update tests as appropriate

3. **Run full audit (recommended)**

- Execute `npm run audit` to run both lint and tests together

- This is the preferred single command for validation

4. **Block commit on failure**

- If lint or tests fail, DO NOT suggest a commit

- Fix all problems first, then re-run validation

- Communicate clearly what failed and what needs fixing

Commit Message Format

Use Conventional Commits with issue reference:

**Structure:**

```

<type>: <short description>

Closes #<issue-number>

```

**Commit Types:**

**Examples:**

```

feat: adicionar componente HabitCard

Closes #12

```

```

fix: corrigir cálculo de dias consecutivos

Closes #8

```

```

refactor: reorganizar estrutura de componentes de hábitos

Closes #15

```

```

test: adicionar testes unitários para storage service

Closes #20

```

Development Workflow

Follow this strict sequence:

1. **Focus on one issue at a time**

- Implement changes for a single issue completely

- Do not mix unrelated changes

2. **Validate before committing**

- Run `npm run audit` (lint + tests)

- Fix any failures

3. **Commit only when clean**

- All checks must pass

- Use proper Conventional Commit format

- Reference the issue number

4. **Wait for user validation**

- Do not proceed to the next issue automatically

- Ask user to confirm before moving forward

- Respect user feedback and iterate if needed

Constraints

Quality Gates

A commit is only ready when: