By name: alembic-recipes description: Provides this project's Recipe-based context to the agent. Recipes are the project's standard knowledge (code patterns + usage guides + structured relations). Use when answering about project standards, Guard, conventions, or when suggesting code. Supports in-context lookup, terminal search (asd search), and on-demand semantic search via MCP tool asd_search (mode=context).
Alembic Recipe Context (Project Context)
This skill provides the agent with this project's context from Alembic Recipes. Recipes are the project's standard knowledge base: code patterns, usage guides, and structured relations.
Knowledge Base Overview
| Part | Location | Purpose |
|---|---|---|
| Recipes | Alembic/recipes/*.md |
Standard code patterns + usage guides; used for AI context, Guard, search |
| Snippets | Alembic/snippets/*.json |
Code snippets synced to IDE via asd install |
| Candidates | Alembic/.asd/candidates.json |
AI-scanned candidates; review in Dashboard then approve |
| Context index | Alembic/.asd/context/ |
Vector index built by asd embed; semantic search via asd_search(mode=context) |
Recipe = one .md file = one specific usage pattern or code snippet. kind: rule (Guard enforced) / pattern (best practice) / fact (structural knowledge). Recipe over project code: When both exist, prefer Recipe as curated standard.
Agent Permission Boundary
| Allowed | Forbidden |
|---|---|
Submit candidates (asd_submit_knowledge / _batch) |
Directly create/modify Recipes |
Search/query (asd_search / asd_knowledge) |
Publish/deprecate/delete |
Confirm usage (confirm_usage) |
Write to Alembic/recipes/ |
How to Find Recipes
- In-context index: Read
references/project-recipes-context.mdin this skill folder - MCP browse:
asd_knowledge(operation=list)with kind/language/category filters - MCP get:
asd_knowledge(operation=get, id)for full content - MCP search:
asd_search(mode=auto)for unified FieldWeighted+semantic search - Terminal:
asd search <keyword>
Recipe over code search: When both find matches, prefer Recipe as source of truth. Cite Recipe title.
How to Use This Context
- Project standards/Guard: Use Recipe content as source of truth
- "How we do X here": Base answer on Recipe content
- Suggesting code: Cite Recipe's code snippet, not raw search results
- Guard/Audit:
// as:auditor MCPasd_guard— both use Recipes as standard - Confirm adoption:
asd_knowledge(operation=confirm_usage, id, usageType)when user uses a Recipe
Auto-Extracting Headers for New Candidates
- From code (Recommended): Extract all import statements from user's code
- From existing Recipes: Check index for matching modules, then
asd_knowledge(operation=get, id)for full content - Via semantic search:
asd_search(mode=context)with query like "import ModuleName"
Related Skills
- alembic-create: Submit knowledge candidates (V3 fields, validation, lifecycle)
- alembic-guard: Code compliance checking against Recipe standards
- alembic-structure: Project structure and knowledge graph