Skip to content

New /pre-ci & /feedback commands for Claude#829

Merged
polmichel merged 7 commits intodevelopfrom
pmi-20260216-new-ci-skill
Feb 25, 2026
Merged

New /pre-ci & /feedback commands for Claude#829
polmichel merged 7 commits intodevelopfrom
pmi-20260216-new-ci-skill

Conversation

@polmichel
Copy link

@polmichel polmichel commented Feb 16, 2026

Why

pre-ci

To resolve issues detected by the CI, avoid back-and-forth push or force-push.

feedback

Enhance Claude capabilities to develop alone and respecting the code conventions and software architecture.

Goal

pre-ci

The /pre-ci Claude command will launch a subset of CI checks locally.

feedback

To identify missing documentation that would allow Claude to directly address correctly the problematics encountered during the session.

Summary by CodeRabbit

  • Documentation
    • Added developer guidance for a local pre-CI workflow to run format, lint, Python tests, docs unit tests, and docs validation sequentially; continues after failures, produces a final pass/fail summary, and advises not to commit or push intermediate changes.
    • Added a structured session feedback process: identify friction points, perform a documentation audit, use a templated feedback report, and follow minimal, option-based steps to apply approved changes.

@coderabbitai
Copy link

coderabbitai bot commented Feb 16, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 44392b5 and 6387a79.

📒 Files selected for processing (2)
  • dev/commands/feedback.md
  • dev/commands/pre-ci.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • dev/commands/feedback.md

Walkthrough

Adds two new Markdown files: dev/commands/pre-ci.md and dev/commands/feedback.md. dev/commands/pre-ci.md documents a local pre-CI workflow with five ordered checks (format, lint, Python unit tests, docs unit tests using vitest, and validate generated documentation), includes explicit command examples, requires running steps sequentially while continuing after failures, and produces a final pass/fail summary; it instructs not to commit or push failing changes. dev/commands/feedback.md defines a four-step interactive session feedback process: friction analysis, documentation audit, a structured session feedback report template, and an apply-changes workflow.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed Title clearly and concisely describes the main change—introducing two new Claude commands (/pre-ci and /feedback) with appropriate specificity.
Description check ✅ Passed Description addresses the 'Why' and 'Goal' sections with relevant context for both commands, but lacks 'What changed', 'How to review', 'How to test', and 'Impact & rollout' sections that would provide comprehensive detail.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@polmichel polmichel changed the base branch from stable to develop February 16, 2026 16:18
@polmichel polmichel force-pushed the pmi-20260216-new-ci-skill branch from 1d1f01d to c667799 Compare February 16, 2026 16:24
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 16, 2026

Deploying infrahub-sdk-python with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6387a79
Status: ✅  Deploy successful!
Preview URL: https://4c36444f.infrahub-sdk-python.pages.dev
Branch Preview URL: https://pmi-20260216-new-ci-skill.infrahub-sdk-python.pages.dev

View logs

@polmichel polmichel changed the title New /ci command for Claude, running CI checks locally New /ci command for Claude that runs a subset of CI checks locally Feb 16, 2026
@polmichel polmichel force-pushed the pmi-20260216-new-ci-skill branch from 2309c9d to 928e723 Compare February 20, 2026 11:14
@polmichel polmichel marked this pull request as ready for review February 20, 2026 11:16
@polmichel
Copy link
Author

For now I will remove the /refactor command. Once we will add additional documentation into /dev folder, this would be a good candidate

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
dev/commands/pre-ci.md (1)

1-1: Consider adding a document-level # heading.

The file starts directly with a prose paragraph. Adding a top-level heading (e.g., # Run Local CI Checks) improves navigability and aligns with standard Markdown conventions for command documents.

✏️ Proposed fix
+# Run Local CI Checks
+
 Run a subset of fast CI checks locally. These are lightweight validations that catch common issues before pushing. Execute each step sequentially and stop on the first failure. Report a summary at the end.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@dev/commands/pre-ci.md` at line 1, Add a top-level Markdown heading above the
existing paragraph to improve navigability and match conventions; insert a line
like "# Run Local CI Checks" (or use the existing opening phrase "Run a subset
of fast CI checks locally." as the heading) at the very top of the document so
the current paragraph becomes the lead description under that heading.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@dev/commands/pre-ci.md`:
- Around line 21-23: The "cd docs && npx --no-install vitest run" line changes
the shell's working directory for subsequent steps; change it to run the vitest
command inside a subshell so the directory change is scoped only to that command
(i.e., ensure the directory change does not persist across Bash tool calls) —
update the line containing "cd docs && npx --no-install vitest run" to use a
subshell-style invocation so later steps (like the "uv run invoke docs-validate"
step) still run from the project root.

---

Nitpick comments:
In `@dev/commands/pre-ci.md`:
- Line 1: Add a top-level Markdown heading above the existing paragraph to
improve navigability and match conventions; insert a line like "# Run Local CI
Checks" (or use the existing opening phrase "Run a subset of fast CI checks
locally." as the heading) at the very top of the document so the current
paragraph becomes the lead description under that heading.

@polmichel
Copy link
Author

For now I will remove the /refactor command. Once we will add additional documentation into /dev folder, this would be a good candidate

To improve the internal documentation in the /dev folder and other parts of the software, I suggest adding a "/feedback" command to prompt Claude to tell us what knowledge was missing during the code session. Ultimately, this will lead us in a state where /refactor command will be able to use internal documentation to proceed.

@polmichel polmichel changed the title New /ci command for Claude that runs a subset of CI checks locally New /pre-ci & /feedback commands for Claude Feb 23, 2026
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
dev/commands/feedback.md (1)

34-72: Template sub-lists are missing blank lines before them.

Each For each X: label inside the template is immediately followed by a bullet list with no blank line (e.g., For each gap:- **Topic**: …). While markdownlint ignores content inside fenced code blocks, any Markdown Claude emits by following this template will itself violate the project's blank-line rule.

♻️ Example fix (repeat for all four "For each X:" occurrences)
 ### Documentation Gaps
 <!-- Things that should be documented but aren't -->

 For each gap:
+
 - **Topic**: What's missing
 - **Where**: Which file should contain this (existing file to update, or new file to create)
 - **Why**: How this would have helped during this session
 - **Suggested content**: A draft of what should be added (be specific and actionable)

As per coding guidelines: "Add blank lines before and after lists in Markdown files."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@dev/commands/feedback.md` around lines 34 - 72, The template in
dev/commands/feedback.md has four occurrences where a "For each X:" label is
immediately followed by a bullet list (e.g., "For each gap:", "For each
correction:", "For each pattern:", "For each update:"), which violates the
project's Markdown rule requiring blank lines before lists; edit the fenced
markdown template to insert a single blank line between each "For each X:" line
and its following list so each label is separated from the dash-starting items
(update all four occurrences in the code block to match the
blank-line-before-list guideline).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@dev/commands/feedback.md`:
- Around line 82-83: Add a blank line between the paragraph "For approved
changes:" and the following bullet list to satisfy the project's Markdown
convention (i.e., insert an empty line before the list that starts with "- Edit
existing files when updating documentation"); update the section containing "For
approved changes:" so there is a blank line before and after the list to avoid
markdownlint failures.

---

Nitpick comments:
In `@dev/commands/feedback.md`:
- Around line 34-72: The template in dev/commands/feedback.md has four
occurrences where a "For each X:" label is immediately followed by a bullet list
(e.g., "For each gap:", "For each correction:", "For each pattern:", "For each
update:"), which violates the project's Markdown rule requiring blank lines
before lists; edit the fenced markdown template to insert a single blank line
between each "For each X:" line and its following list so each label is
separated from the dash-starting items (update all four occurrences in the code
block to match the blank-line-before-list guideline).
ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 928e723 and cf06649.

📒 Files selected for processing (1)
  • dev/commands/feedback.md

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@dev/commands/feedback.md`:
- Around line 17-80: The Markdown violates the markdownlint rule requiring blank
lines before and after lists in dev/commands/feedback.md — add a single blank
line immediately before and after every list block (including the Step 2
reference bullet list, each "For each ..." explanatory list under "Step 3:
Generate Report" and the Step 4 options list), and ensure paragraphs like the
"Format" block and headings ("Step 3: Generate Report", "Step 4: Apply Changes")
are separated from adjacent lists by blank lines; update the file so lists under
those headings (and the example fenced block) have a blank line above and below
to satisfy the lint rule.

In `@dev/commands/pre-ci.md`:
- Around line 32-35: Add a trailing blank line after the final Markdown list
(the list that starts with "Run each step in order using the Bash tool." and
ends with "Do NOT commit or push anything.") so the file ends with a blank line;
also ensure there is a blank line before the list if missing to satisfy the
guideline "Add blank lines before and after lists in Markdown files."

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between cf06649 and 8abbde2.

📒 Files selected for processing (2)
  • dev/commands/feedback.md
  • dev/commands/pre-ci.md

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
dev/commands/feedback.md (1)

43-44: ⚠️ Potential issue | 🟡 Minor

Add blank lines before each list inside the template code block.

The four For each …: paragraphs inside the fenced template are still followed immediately by their bullet lists with no blank line, which will trigger markdownlint MD032 failures when the template content is linted.

📝 Proposed fix
 For each gap:
+
 - **Topic**: What's missing
 For each correction:
+
 - **File**: Path to the file
 For each pattern:
+
 - **Pattern**: Description of the convention
 For each update:
+
 - **Action**: Add / Update / Remove

As per coding guidelines: "Add blank lines before and after lists in Markdown files."

Also applies to: 52-53, 60-61, 68-69

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@dev/commands/feedback.md` around lines 43 - 44, Insert a blank line between
each "For each ..." paragraph and its following bullet list inside the fenced
template in dev/commands/feedback.md so lists are separated from their preceding
paragraphs; specifically, update the four occurrences of the "For each gap:"
(and the similar "For each ..." paragraphs at the other noted locations) in the
template so there is an empty line before the subsequent "- **Topic**: ..."
bullet list to satisfy MD032 and the project's markdown guidelines.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@dev/commands/feedback.md`:
- Around line 43-44: Insert a blank line between each "For each ..." paragraph
and its following bullet list inside the fenced template in
dev/commands/feedback.md so lists are separated from their preceding paragraphs;
specifically, update the four occurrences of the "For each gap:" (and the
similar "For each ..." paragraphs at the other noted locations) in the template
so there is an empty line before the subsequent "- **Topic**: ..." bullet list
to satisfy MD032 and the project's markdown guidelines.

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8abbde2 and 44392b5.

📒 Files selected for processing (2)
  • dev/commands/feedback.md
  • dev/commands/pre-ci.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • dev/commands/pre-ci.md

@polmichel polmichel force-pushed the pmi-20260216-new-ci-skill branch from 44392b5 to 6387a79 Compare February 25, 2026 09:24
@polmichel polmichel merged commit 998e3fe into develop Feb 25, 2026
15 checks passed
@polmichel polmichel deleted the pmi-20260216-new-ci-skill branch February 25, 2026 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants