Skip to content
cccskills
FreePublished on GitHub

djls-domain-conventions

Use when editing Django template parser tags, validation errors, diagnostics, environment scanning, inspector data, Python environment inventory, or DJLS domain model code. Handles project-specific semantic and parser conventions.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207 stars(GitHub 207 + cccskills 0)

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

DJLS Domain Conventions

Use this for changes to template parsing, semantic validation, environment scanning, diagnostics, and inspector-derived project data.

Template parser

  • Node::Tag.bits excludes the tag name.
  • Example: {% load i18n %} becomes name: "load", bits: ["i18n"].
  • Functions processing bits work with tag arguments only.
  • Extracted text and its span are computed by the same parse, in the crate that owns the syntax. Do not re-derive quote/content spans in semantic or IDE consumers.

Environment scanning

  • External rule/model scan orchestration lives in crates/djls-db/src/scanning.rs.
  • Project context, inspector data, and module resolution live in crates/djls-semantic/src/project/:
    • project.rs defines Project.
    • symbols.rs defines TemplateLibraries, TemplateLibrary, TemplateSymbol, and inspector response types.
    • resolve.rs handles Python module and model-file discovery.
    • python.rs handles interpreter discovery.
  • Static Python extraction lives in crates/djls-semantic/src/python/.

Validation errors

Quick-fix edits are derived from typed ValidationError values against the current Salsa snapshot inside the request handler. Keep Diagnostic.data as None; do not serialize internal error or edit shapes into the LSP wire contract.

When adding or removing ValidationError variants, update:

  • errors.rs
  • djls-ide/src/diagnostics.rs S-code mapping
  • test helpers

Use:

rg "ValidationError" crates/ -g '*.rs'

Semantic model

  • Cross-file semantic queries depend on small per-file derived products (e.g. template_symbols), never on other files' full parses directly.
  • Code over config: tag-spec knowledge acquisition prefers static extraction from Python source; tagspec config is a last-resort escape hatch, never primary.
  • Semantic features bind to TagRole, never tag names.
  • Derived project facts carry explicit completeness/termination states (e.g. ChainEnd, TemplateDirStatus); consumers branch on them rather than inferring from emptiness.

Local runtime state

  • Server logs: ~/.cache/djls/djls.log.YYYY-MM-DD (newest seven kept)
  • Inspector cache: ~/.cache/djls/inspector/

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

dex

Free

Manage tasks via dex CLI. Use when breaking down complex work, tracking implementation items, or persisting context across sessions.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

Use when adding release notes, changelog entries, user-facing changes, internal changelog notes, or preparing a PR/release for django-language-server. Handles Keep a Changelog formatting and entry style.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

Maintain the ported ty resolver test corpus in crates/djls-project/tests/resolve.rs. Use when bumping the ruff git pin in the workspace Cargo.toml or when adding/reviewing module-resolution tests.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

Use when editing djls-extraction or Rust code that consumes Ruff Python AST APIs, including parse_module, parameters, boxed expressions, f-strings, or exception handlers. Handles known Ruff AST shape gotchas in django-language-server.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

Use when editing Salsa inputs, tracked functions, database traits, setters, SemanticDb, crate::Db, invalidation behavior, or incremental computation in django-language-server. Handles project-specific Salsa conventions and required impl updates.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

Use when running tests, fixing failing tests, updating snapshots, syncing corpus data, validating before push, or working with Django matrix testing in django-language-server. Handles cargo, just, nox, insta, corpus, clippy, fmt, and lint commands.

The English summary is being prepared. Showing the original description.

joshuadavidthomas/django-language-server207Updated Oct 22, 2026

See all skills by joshuadavidthomas

Report a problem with this skill