Guidelines

📐 Architecture Guidelines

The Architecture Guidelines system automatically scrapes your organization's wiki (Confluence, GitLab Wiki, or Markdown) and injects tech constraints into agent system prompts.

How It Works

Confluence / GitLab Wiki / Markdown
         ↓ guidelines_scraper.py
         ↓
    SQLite: guidelines.db
         ↓
    MCP tools (guidelines_summary, search, get, stack)
         ↓
  Agent system prompts (auto-injected for dev/arch/security roles)

Domain vs Project Level

Scope	Usage	Config
Project-level	Guidelines for one project	--project my-project
Domain-level	Shared guidelines across N projects	--project domain:bscc

To use domain-level guidelines, add the domain field to your project YAML:

# projects/my-project.yaml
project:
  name: my-project
  domain: bscc   # ← agents will load guidelines from domain:bscc

Setup

1. Scrape from Confluence

python -m mcp_lrm.guidelines_scraper \
  --source confluence \
  --url https://confluence.company.com \
  --space BSCC \
  --token $CONFLUENCE_TOKEN \
  --project domain:bscc \
  --verbose

2. Scrape from GitLab Wiki

python -m mcp_lrm.guidelines_scraper \
  --source gitlab \
  --url https://gitlab.company.com \
  --token $GITLAB_TOKEN \
  --project domain:bscc

3. Scrape from local Markdown

python -m mcp_lrm.guidelines_scraper \
  --source markdown \
  --path ./docs/architecture/ \
  --project domain:bscc

Database Schema

Tables in data/guidelines.db:

Table	Content
guideline_pages	Scraped wiki pages with summary and tags
guideline_items	Extracted constraints with categories
guideline_meta	Sync metadata per project/space
guideline_fts	FTS5 full-text search index

Constraint Categories

• must_use — Mandatory technologies/patterns
• forbidden — Banned technologies
• standard — Recommended standards
• pattern — Architectural patterns
• adr — Architecture Decision Records

MCP Tools

Agents with the architecture, dev, security, reviewer, or qa role can use:

Tool	Description
lrm_guidelines_summary	Compact summary of constraints for a project/domain
lrm_guidelines_search	Full-text search across all guidelines
lrm_guidelines_get	Get full content of a specific page
lrm_guidelines_stack	Get the technology stack (must_use + standard)

Prompt Injection

For eligible roles, guidelines are automatically prepended to the system prompt:

## Architecture & Tech Guidelines (DSI)
### Must Use
- Java 17 LTS (backend services)
- PostgreSQL (primary database)
### Forbidden
- MongoDB (not approved by DSI)
...

The injection is cached for 5 minutes per project/domain.

Settings Integration Card

In Settings → Integrations → Architecture, the Architecture Guidelines (Wiki) card configures:

Field	Description
source	confluence / gitlab / markdown
space	Confluence space key or GitLab project path
confluence_url	Base URL of your Confluence instance
domain	Domain name (e.g. bscc)
auto_inject	Auto-inject in system prompts (default: true)