Support
Find answers to common questions about Engineering Framework. If you can't find what you need here, open an issue on GitHub.
Report a bug
Found something broken? Email us with steps to reproduce and we'll investigate promptly.
support@engineeringframework.devGeneral questions
Have a question that isn't answered below? Drop us an email and we'll get back to you.
support@engineeringframework.devFrequently asked questions
How do I connect Claude Code to my project?
Open your project in the Engineering Framework dashboard and look for the "Claude Code Integration" card. It generates a ready-to-use MCP server config for your .claude/settings.json and a CLAUDE.md snippet scoped to your project. Copy both into your repository, start a Claude Code session, and your AI agent will have direct access to planning tools for that project.
What are checklists, definitions, and templates?
The framework ships with a curated library of engineering planning artifacts — things like SLOs, architecture decision records, rollback plans, threat models, user stories, and success criteria. Each item has a definition (what it is and why it matters) and a template (a fill-in markdown document optimized for AI generation). Browse them all under Framework in the dashboard.
What MCP tools does the server expose?
The MCP server exposes planning-specific prompts: start_planning_session (assess planning health and identify gaps), generate_artifact (generate a specific planning document from a checklist item and template), and review_artifact (review an existing artifact against the definition). It also exposes data tools for listing projects, framework items, and checklist status. All tools enforce the same OpenFGA permissions as the web UI.
How do permissions work?
Engineering Framework uses OpenFGA for relationship-based access control. Permissions are defined at three levels: organization (admin, member), department (lead, member), and project (owner, editor, viewer). Every action in the web UI and every MCP tool call is validated against these relationships. Admins can configure roles and manage membership from the Users and Roles sections of the dashboard.
How does Git repository integration work?
In the project settings, you can link a Git repository to your Engineering Framework project. This associates your planning context with a specific codebase so that generated CLAUDE.md and MCP config snippets reference the correct project. Repository linking is used by the Claude Code integration to scope AI planning sessions to the right project automatically.
What are project phases?
Phases let you organize planning work into stages that match your engineering process — for example Discovery, Architecture, Implementation, and Launch Readiness. Organization admins can configure custom phases under Settings. Checklist completion is tracked per phase so you can see exactly what is done, in progress, and still missing at each stage of a project.
How do I set up my organization?
After signing up, you will be prompted to create your organization and configure basic settings. From the dashboard, you can then invite users, create departments, set up project phases, and create your first project. New users are invited by email and assigned a role when they accept. Organization admins have full control over membership, roles, and settings.
Does the MCP server require a specific Claude Code version?
The MCP server uses StreamableHTTP transport (the current MCP standard), which is compatible with Claude Code and any MCP client that supports the HTTP transport type. Make sure your Claude Code installation is up to date. The connection is authenticated via your Auth0 JWT — no additional API keys are needed beyond your Engineering Framework login.