Best Practices Library

The Library is an organisation-wide knowledge base of engineering and delivery best practices. Practices can be assigned to projects and used by the AI during refinement to generate context-appropriate criteria.

Browsing the Library

Click Library in the sidebar to open the practices list. Practices are organised into categories:

• Accessibility — WCAG guidelines, inclusive design
• Architecture — patterns, boundary decisions, dependency management
• Clean Code — naming, structure, readability
• Delivery — CI/CD, deployment, change management
• Design — UX, visual consistency, mobile responsiveness
• Infrastructure — cloud resources, networking, security
• Management — process, estimation, stakeholder communication
• Observability — logging, tracing, alerting
• Performance — optimisation, caching, scalability
• Security — OWASP, secrets, authorisation
• SOLID — software design principles
• Testing — unit, integration, e2e, coverage

Filter the list by category using the filter chips at the top.

Enforcement Levels

Each practice has one of three enforcement levels:

Assigning a Practice to a Project

1. Open a practice card.
2. Click Assign to Project.
3. Select the project(s) you want to associate with this practice.

Assigned practices are marked with a checkmark in the library list view.

Practices and AI Refinement

When a project has practices assigned, the AI refinement assistant uses them as additional context. For example, if your project has the Accessibility and WCAG AA colour contrast practices assigned, the AI will automatically suggest accessibility-related acceptance criteria and edge cases for every item it refines.

Adding Custom Practices

Organisations can create custom practices in their library to capture team-specific standards. Click Add Practice and fill in the title, description, category, and enforcement level.