LogoLogo
Packmind CloudChangelogGet supportJoin Slack
  • 👋Welcome!
  • 🪐Manage spaces
  • 🔐Security and data
  • 🐞Troubleshooting guides
  • 🚀First steps
    • Enable and configure AI
    • Connect your Git platform
  • 📥Capture your coding practices
    • How to create coding practices
    • Review practices in the Inbox
  • 🔍Enforce practices in your code
    • Setup practices detection with the AI Agent
    • Packmind CLI
      • Run with NPM
      • Run with Docker
      • SonarQube Integration
      • Run in Gitlab CI
      • Usage
  • Coding Assistants Integration
  • 👩‍💻Plugins & Integrations
    • IDE Plugins
      • 🚀Packmind's IDE plugins use cases
      • Visual Studio Code
      • Visual Studio
      • JetBrains IDEs
      • Eclipse
      • Xcode
      • Packmind Tech Coach
    • 🔔Get notifications
  • 📖Best practices management
    • Manage your practices
      • Import, copy and export practices
      • Use categories to organize your practices
      • Manage duplications of practices
      • Move all practices from a space to another space
      • Styling with Markdown
      • Multi-file examples on coding practices
    • 📰Scheduler to push practices
  • ↔️API Reference
    • Authentication
    • Documentation
  • ⚙️Account & Settings
    • 👩‍💼Manage users
    • 💵Subscription and Billing
    • 🔓Single Sign-On (SSO) in Packmind
      • Enable SSO for Packmind Cloud
      • Enable SSO for Packmind Self-Hosted
  • 🏠On-Premise version
    • Release notes - Self-Hosted versions
    • Install the Self-Hosted version
      • Migrate from a legacy setup (Mongo 2.x)
    • Connect a SMTP server
    • Authentication
      • Authentication with OpenLDAP
      • Authentication by SSO
      • Authentication with Active Directory
Powered by GitBook
On this page
  • 1. Practices capture from Merge/Pull requests
  • Configure Git integration
  • Run code review analysis
  • Automatic analysis
  • Notes on created practices
  • 2. Capture from static textual content
  • 3. Create practices manually from your IDE
  • 4. Create practices manually from the web app
  • Next Step: Review the captured practices

Was this helpful?

  1. Capture your coding practices

How to create coding practices

PreviousConnect your Git platformNextReview practices in the Inbox

Last updated 16 days ago

Was this helpful?

Coding practices can be captured by 4 different methods:

  1. Through analysis of code reviews

  2. Through text import

  3. Using Packmind IDE plugins

  4. Using manual creation in the web app

Note that Packmind supports any language, including Web technologies, Front/Back frameworks, DevOps tooling, Gherkin syntax, ...

1. Practices capture from Merge/Pull requests

Code reviews are a key place for developers and tech leaders to discuss best coding practices. Packmind can integrate with your Git platform to continuously monitor your code reviews discussions, and let Packmind AI extract coding practices from them.

Configure Git integration

Get started by configuring your . In short, go to Settings -> Git Settings, then select your Git integration, and pick the repositories you want to monitor.

Keep in mind that each Packmind space has its own Git integrations.

We currently support GitHub and GitLab. Azure DevOps and BitBucket will come soon in H1 2025.

Run code review analysis

The next step is to navigate to the Inbox menu and click on the New -> Merge Request comments button. Then, click on the New analysis button.

You'll have listed the Git repositories you've configured for your space.

Click on Run analysis to ask Packmind AI to scan your latest merge/pull requests:

  • On the first import, it will browse your history of MR/PRs until it finds a set of 20 practices.

  • On further imports, it will analyze MR/PRs merged since the last time you ran an import.

The extraction process will run in the background and can take a few minutes to complete. The execution status is available on this page, and potential errors (such as Authorization Token expired) will be listed there.

Automatic analysis

Once you've configured and run a first analysis of your Git repositories, they'll be automatically analyzed weekly to generate at most three new coding practices in your inbox. This automatic scan will not be executed if your inbox has over 20 coding practices.

Notes on created practices

  • For each created practice will keep track of the MR/PRs discussions from which it has been created. It will provide useful context when you'll have to review the practice.

  • Packmind AI will generate a positive and negative example based on the code review context, so it will not be a raw copy/paste of the PR/MR content.

2. Capture from static textual content

This mode allows you to let Packmind AI extract coding practices from textual input, such as:

  • A Wiki page that contains descriptions of coding guidelines and practices

  • A public web page (blog post, technical documentation, ...)

  • A file containing Architecture Decision Records

Go into the Inbox and click on New -> Generation with AI. Then, simply copy and paste your content, submit the form, and it will take a few seconds or few minutes, depending on the input size, to process the content and create coding practices.

If you have several textual files to import, you can submit multiple inputs separately, they'll be processed in background.

If your content comes from Wikis (Notion, Confluence, ...), we advise you to export first your page into Markdown to preserve formatting. Then, paste the content of the Markdown files into Packmind.

All the generated practices will be available in the Inbox.

3. Create practices manually from your IDE

From any file, select some code, right-click and access the Packmind plugin menu, and indicate whether you're identifying a new practice or an existing one. Indicate also if it's related to:

  • A positive example: a source code compliant with the best practice

  • A negative example: a source code not compliant with the best practice

Fill the required fields, and this will be sent in the provided space in Packmind. All the source code file will be sent, and the example location is stored as well and will be displayed in the Packmind Web application.

Show how to fix bad practices

When you identify a negative example, you can then modify this code to fix the bad practices.

Right-click again on the editor and select Packmind -> Send as a correction to the previous practice example to indicate the new code state has fixed the previous identified bad practice.

4. Create practices manually from the web app

You can create practices directly in the web app using the creation form.

Go into the Inbox and click on New -> Manual creation. Then, just fill in the name, description, language, categories, and examples.

In the creation form only the name is required, but to be validated the practice needs to have at least one negative example.

Next Step: Review the captured practices

Whatever the capture method you chose, all these created practices must be reviewed in the Inbox to be part of your Packmind space.

When completed, you'll see how many practices have been generated . All the practices generated will be available in the inbox.

Keep in mind that you'll have to enable Packmind AI to benefit from this feature

Keep in mind that you'll have to enable Packmind AI to benefit from this feature

Let's dive into this

📥
✅
✨
✨
👀
Git repositories
Review practices in the Inbox
Example with VSCode