{ "$schema": "agentmaurice.agent_guide/v1", "version": "1.3.0", "generated_from": "agent-maurice-site typed agent guide", "languages": [ "en", "fr" ], "single_prompt": { "fr": "Configure AgentMaurice pour cet assistant en suivant https://agentmaurice.ai/llms.txt, puis aide-moi à créer un outil de suivi de mes clients. Réutilise mon installation si elle existe.", "en": "Set up AgentMaurice for this assistant using https://agentmaurice.ai/llms.txt, then help me build a customer-tracking tool. Reuse my existing installation if there is one.", "entrypoint": "https://agentmaurice.ai/llms.txt" }, "surface_routing": { "local_terminal": { "when": "Coding agent with a terminal on the requested machine", "procedure": "https://agentmaurice.ai/en/one.md", "stop_if": "Unsupported OS/arch, container or SSH host that is not the requested machine, or no public archive" }, "existing_instance": { "when": "An AgentMaurice installation or instance is already reachable", "procedure": "Reuse identity, data dir, Skill and linked context; do not create a second install by default", "stop_if": "Access expired or multiple targets without an explicit human choice" }, "hosted_assistant": { "when": "Hosted assistant without access to the person's machine", "procedure": "Orient to a qualified remote connector/plugin; guide human local install and keep the pending request", "stop_if": "Never announce a local install completed from a cloud terminal" }, "remote_or_container": { "when": "Agent runs in a container or on a remote host", "procedure": "Confirm that environment is the intended install target before downloading", "stop_if": "Network forbidden or surface unsupported: diagnose and stop, no network bypass" } }, "concepts": { "en": { "agent": { "summary": "A deployed, operable AI product resource managed by AgentMaurice.", "relationship": "An Agent is produced from one Agent Spec and owns managed Workflows and MiniApps." }, "agent_spec": { "summary": "The versioned, Git-native desired state for one Agent.", "relationship": "It is checked, planned, approved when required, applied, and verified." }, "workflow": { "summary": "An executable business process managed by an Agent Spec.", "relationship": "Workflows orchestrate models, MCP tools, code, data, and human gates." }, "miniapp": { "summary": "An interactive runtime surface managed by an Agent Spec.", "relationship": "A MiniApp presents guided inputs or results while side effects stay in Workflows." }, "module": { "summary": "A versioned executable package contributing Workflows, MiniApps, schemas, assets, and docs.", "relationship": "A Module is installed into an Application; it is not a Skill or an Agent Spec." }, "application": { "summary": "An organizational runtime surface composed of one or more Modules and Agents.", "relationship": "Applications are composed with maurice app; Agent Specs remain in consuming Agent projects." }, "mcp": { "summary": "The protocol surface through which agents discover and call governed tools.", "relationship": "WebMCP explains onboarding in the browser; External Inception operates an authenticated instance." }, "doctor": { "summary": "A diagnostic that reports readiness and the safest next action.", "relationship": "This public Doctor is advisory; inception_agent_doctor observes authenticated runtime state." }, "one": { "summary": "AgentMaurice One is the free, proprietary local runtime for personal and professional use. Build Agents, Modules and Applications locally; use a paid AgentMaurice server offer when sharing or scaling the runtime.", "relationship": "Install Maurice from https://agentmaurice.ai/en/one.md. The script downloads the archive from get.agentmaurice.app and checks its SHA-256. The stable CLI manifest still lists v2.1.29; a CLI download alone does not install Maurice." } }, "fr": { "agent": { "summary": "Une ressource produit IA déployée et opérable, gérée par AgentMaurice.", "relationship": "Un Agent provient d’une Agent Spec et possède ses Workflows et MiniApps managés." }, "agent_spec": { "summary": "L’état désiré versionné et Git-native d’un Agent.", "relationship": "Elle est vérifiée, planifiée, approuvée si nécessaire, appliquée puis vérifiée." }, "workflow": { "summary": "Un processus métier exécutable géré par une Agent Spec.", "relationship": "Un Workflow orchestre modèles, outils MCP, code, données et validations humaines." }, "miniapp": { "summary": "Une surface runtime interactive gérée par une Agent Spec.", "relationship": "Une MiniApp présente saisies ou résultats ; les effets de bord restent dans les Workflows." }, "module": { "summary": "Un package exécutable versionné qui apporte Workflows, MiniApps, schémas, assets et docs.", "relationship": "Un Module s’installe dans une Application ; ce n’est ni un Skill ni une Agent Spec." }, "application": { "summary": "Une surface runtime d’organisation composée de Modules et d’Agents.", "relationship": "Elle se compose avec maurice app ; les Agent Specs restent dans les projets Agents consommateurs." }, "mcp": { "summary": "Le protocole par lequel les agents découvrent et appellent des outils gouvernés.", "relationship": "WebMCP guide dans le navigateur ; External Inception opère une instance authentifiée." }, "doctor": { "summary": "Un diagnostic qui rapporte la préparation et la prochaine action sûre.", "relationship": "Ce Doctor public conseille ; inception_agent_doctor observe l’état runtime authentifié." }, "one": { "summary": "AgentMaurice One est le runtime local gratuit et propriétaire pour les usages personnels et professionnels. Construisez Agents, Modules et Applications en local ; passez à une offre serveur AgentMaurice payante pour partager le runtime ou monter en charge.", "relationship": "Installez Maurice depuis https://agentmaurice.ai/fr/one.md. Le script télécharge l’archive sur get.agentmaurice.app et vérifie son SHA-256. Le manifeste CLI stable annonce encore v2.1.29 ; télécharger la CLI seule n’installe pas Maurice." } } }, "tools": [ { "name": "explain_agentmaurice", "read_only": true, "input_schema": { "type": "object", "additionalProperties": false, "required": [ "topic" ], "properties": { "topic": { "type": "string", "enum": [ "agent", "agent_spec", "workflow", "miniapp", "module", "application", "mcp", "doctor", "one" ], "description": "AgentMaurice concept to explain." } } }, "output_schema": "agentmaurice.explanation/v1" }, { "name": "recommend_deployment", "read_only": true, "input_schema": { "type": "object", "additionalProperties": false, "required": [ "operating_model", "scale", "requirements" ], "properties": { "operating_model": { "type": "string", "enum": [ "local", "managed", "customer_infrastructure" ], "description": "Who operates the AgentMaurice runtime." }, "scale": { "type": "string", "enum": [ "individual", "team", "fleet" ], "description": "Expected operating scale." }, "requirements": { "type": "array", "uniqueItems": true, "items": { "type": "string", "enum": [ "offline", "data_residency", "high_availability", "sso_rbac" ], "description": "Deployment requirement." }, "description": "Non-sensitive deployment requirements; use an empty array when none apply." } } }, "output_schema": "agentmaurice.deployment_recommendation/v1" }, { "name": "onboarding_doctor", "read_only": true, "input_schema": { "type": "object", "additionalProperties": false, "required": [ "objective", "client", "instance_access", "git_state", "environment" ], "properties": { "objective": { "type": "string", "enum": [ "build_agent", "build_application", "develop_module", "operate_existing" ], "description": "Target outcome." }, "client": { "type": "string", "enum": [ "codex", "claude_code", "cursor", "windsurf", "generic" ], "description": "Coding agent or editor." }, "instance_access": { "type": "string", "enum": [ "yes", "no", "unknown" ], "description": "Whether AgentMaurice instance access exists." }, "git_state": { "type": "string", "enum": [ "clean", "dirty", "absent", "unknown" ], "description": "Current Git workspace state." }, "environment": { "type": "string", "enum": [ "sandbox", "development", "staging", "production", "unknown" ], "description": "Target environment." } } }, "output_schema": "agentmaurice.onboarding_doctor/v1" }, { "name": "get_one_guide", "read_only": true, "input_schema": { "type": "object", "additionalProperties": false, "properties": {} }, "output_schema": "agentmaurice.one_guidance/v1" } ], "doctor_contract": { "$schema": "agentmaurice.onboarding_doctor_contract/v1", "output_schema": "agentmaurice.onboarding_doctor/v1", "inputs": { "objective": [ "build_agent", "build_application", "develop_module", "operate_existing" ], "client": [ "codex", "claude_code", "cursor", "windsurf", "generic" ], "instance_access": [ "yes", "no", "unknown" ], "git_state": [ "clean", "dirty", "absent", "unknown" ], "environment": [ "sandbox", "development", "staging", "production", "unknown" ] }, "objectives": { "build_agent": { "recommended_surface": "maurice_cli", "instance_required": true, "git_required": true, "rail": [ "connect", "init|pull", "edit", "commit", "spec deploy", "human approval when required", "apply", "verify" ] }, "build_application": { "recommended_surface": "maurice_app_cli", "instance_required": true, "git_required": true, "rail": [ "app init", "app add", "app plan", "human approval when required", "app apply", "app status" ] }, "develop_module": { "recommended_surface": "maurice_module_cli", "instance_required": false, "git_required": true, "rail": [ "module init", "module validate", "module test", "install in test Application", "publish through governed rail" ] }, "operate_existing": { "recommended_surface": "external_inception", "instance_required": true, "git_required": false, "rail": [ "inception_agent_scopes_list", "inception_agent_doctor", "inception_mcp_capabilities", "resolve runtime tools" ] } }, "decision_order": [ "For build_agent or build_application with instance_access=no and environment=sandbox or development: status=blocked, recommended_surface=maurice_one, workflow=[], next_action=prepare_one. Read the One guide availability before installation; rerun Doctor after local authentication is verified.", "If instance_required and instance_access=no: status=blocked, next_action=book_demo.", "If git_required and git_state is dirty or absent: status=blocked, next_action=review_git.", "If an applicable prerequisite or environment is unknown: status=needs_input.", "Otherwise: status=ready and follow the objective rail." ], "human_gate": "For staging or production, a distinct authenticated human approves the exact plan before apply.", "security": "Use placeholders only. Never accept or emit raw secrets, bearer tokens, bootstrap values, or organization identifiers." }, "deployment_contract": { "$schema": "agentmaurice.deployment_recommendation_contract/v1", "decision_order": [ { "when": "operating_model=customer_infrastructure OR scale=fleet OR high_availability OR sso_rbac", "recommendation": "kubernetes" }, { "when": "operating_model=local AND scale=individual AND NOT data_residency", "recommendation": "one" }, { "when": "otherwise", "recommendation": "managed_vm" } ], "warning": "When data_residency is required, confirm hosting region and retention policy before production." }, "one": { "en": { "$schema": "agentmaurice.one_guide/v1", "availability": { "status": "public_alpha", "checked_on": "2026-09-29", "installable_from_this_guide": true, "cli_manifest": "https://get.agentmaurice.app/products/mauricecli/latest.json", "observed_cli_version": "v2.1.29", "one_download_url": "https://get.agentmaurice.app/products/one/download" }, "title": "Start locally with AgentMaurice One", "summary": "AgentMaurice One is the free, proprietary local runtime for personal and professional use. Build Agents, Modules and Applications locally; use a paid AgentMaurice server offer when sharing or scaling the runtime.", "availabilityText": "Install Maurice from https://agentmaurice.ai/en/one.md. The script downloads the archive from get.agentmaurice.app and checks its SHA-256. The stable CLI manifest still lists v2.1.29; a CLI download alone does not install Maurice.", "installation": "Follow the procedure at https://agentmaurice.ai/en/one.md. The script selects the newest public archive for this machine and accepts only the published flags. Do not guess another installer, download URL, or flag.", "platforms": "macOS arm64 is signed. Linux amd64 and arm64 are checksummed. Mac Intel and Windows have no public archive yet.", "workflowTitle": "For an already provisioned Maurice installation", "steps": [ { "label": "Inspect the installed command contract. Continue only if start, status, doctor and stop describe the local Maurice lifecycle.", "command": "maurice docs --full --format json" }, { "label": "Start explicitly. For a fresh start require ready=true and ready_checked=true. If already_running=true, verify the existing instance with status and doctor.", "command": "maurice start --json" }, { "label": "Verify the process is running.", "command": "maurice status --json" }, { "label": "Require running, health_checked, health_ok, storage_checked and storage_ok. The local Doctor does not verify LLM access or MCP execution.", "command": "maurice doctor --json" } ], "handoff": "Then load the canonical Skill. Inspect the CLI context and use only the authentication and Agent scope supplied by this installation. Inspect maurice tools list before concluding that a runtime tool is unavailable. Configure the required LLM or MCP credentials through the instance, then validate one real operation before claiming the Application works. If local authentication or a required capability is missing, report that prerequisite instead of inventing a bootstrap.", "finish": "Stop only the local instance you started when it is no longer needed. If you use --data-dir, keep the same value for every lifecycle command. Do not publish the local runtime on a public interface.", "limitations": "Doctor still needs --data-dir, and a workflow call still needs --runtime-url http://127.0.0.1:5011, until the connected context keeps those values. Windows and Mac Intel have no public archive. Do not present the stable CLI manifest as a Maurice installer.", "readGuide": "Read the AgentMaurice One guide", "shutdown_command": "maurice stop --json" }, "fr": { "$schema": "agentmaurice.one_guide/v1", "availability": { "status": "public_alpha", "checked_on": "2026-09-29", "installable_from_this_guide": true, "cli_manifest": "https://get.agentmaurice.app/products/mauricecli/latest.json", "observed_cli_version": "v2.1.29", "one_download_url": "https://get.agentmaurice.app/products/one/download" }, "title": "Démarrer en local avec AgentMaurice One", "summary": "AgentMaurice One est le runtime local gratuit et propriétaire pour les usages personnels et professionnels. Construisez Agents, Modules et Applications en local ; passez à une offre serveur AgentMaurice payante pour partager le runtime ou monter en charge.", "availabilityText": "Installez Maurice depuis https://agentmaurice.ai/fr/one.md. Le script télécharge l’archive sur get.agentmaurice.app et vérifie son SHA-256. Le manifeste CLI stable annonce encore v2.1.29 ; télécharger la CLI seule n’installe pas Maurice.", "installation": "Suivez la procédure https://agentmaurice.ai/fr/one.md. Le script choisit la dernière archive publique pour cette machine et n’accepte que les drapeaux publiés. N’inventez ni un autre installeur, ni une URL, ni un drapeau.", "platforms": "macOS arm64 est signé. Linux amd64 et arm64 sont vérifiés par checksum. Mac Intel et Windows n’ont pas encore d’archive publique.", "workflowTitle": "Pour une installation Maurice déjà provisionnée", "steps": [ { "label": "Inspecter le contrat des commandes installées. Continuer uniquement si start, status, doctor et stop décrivent le lifecycle local de Maurice.", "command": "maurice docs --full --format json" }, { "label": "Démarrer explicitement. Pour un nouveau démarrage, exiger ready=true et ready_checked=true. Si already_running=true, vérifier l’instance existante avec status et doctor.", "command": "maurice start --json" }, { "label": "Vérifier que le processus tourne.", "command": "maurice status --json" }, { "label": "Exiger running, health_checked, health_ok, storage_checked et storage_ok. Le Doctor local ne vérifie ni l’accès LLM ni l’exécution MCP.", "command": "maurice doctor --json" } ], "handoff": "Charger ensuite le Skill canonique. Inspecter le contexte CLI et utiliser uniquement l’authentification et le scope Agent fournis par cette installation. Consulter maurice tools list avant de conclure qu’un tool runtime manque. Configurer les accès LLM ou MCP nécessaires via l’instance, puis valider une opération réelle avant d’annoncer que l’Application fonctionne. Si l’authentification locale ou une capacité requise manque, signaler ce prérequis sans inventer de bootstrap.", "finish": "Arrêter uniquement l’instance locale que vous avez démarrée lorsqu’elle n’est plus nécessaire. Si vous utilisez --data-dir, conserver la même valeur pour chaque commande de lifecycle. Ne pas exposer le runtime local sur une interface publique.", "limitations": "Doctor a encore besoin de --data-dir, et un workflow call a encore besoin de --runtime-url http://127.0.0.1:5011, tant que le contexte connecté ne conserve pas ces valeurs. Windows et Mac Intel n’ont pas d’archive publique. Ne présentez pas le manifeste CLI stable comme un installeur Maurice.", "readGuide": "Lire le guide AgentMaurice One", "shutdown_command": "maurice stop --json" } }, "examples": [ { "input": { "objective": "build_agent", "client": "codex", "instance_access": "yes", "git_state": "clean", "environment": "development", "locale": "en" }, "output": { "$schema": "agentmaurice.onboarding_doctor/v1", "status": "ready", "objective": "build_agent", "recommended_surface": "maurice_cli", "prerequisites": [ { "id": "instance", "status": "met", "action": "Use only the target and scope returned by the bootstrap." }, { "id": "git", "status": "met", "action": "Keep the repository clean through planning." }, { "id": "environment", "status": "met", "action": "Follow the policy for this environment." } ], "workflow": [ { "order": 1, "label": "Connect the client with the single-use link generated in AgentMaurice OS.", "command_template": "maurice agent connect \"\" --client codex --env development --agent-alias --dir ." }, { "order": 2, "label": "Initialize a new Agent Spec or pull the existing remote state.", "command_template": "maurice spec init|pull --env development --agent-alias --dir . --json" }, { "order": 3, "label": "Edit, check, and commit the Git-native files.", "command_template": "maurice spec check --env --agent-alias --dir . --json" }, { "order": 4, "label": "Deploy; resume the same command after human approval when required.", "command_template": "maurice spec deploy --env --agent-alias --tests auto --dir . --json" } ], "human_gates": [], "next_action": { "kind": "follow_workflow", "label": "Follow the workflow in order and verify the final result." }, "warnings": [ "Never request, display, or write a raw secret; use references only.", "Never infer an organization, environment, or Agent from a human name." ], "links": [ "https://agentmaurice.ai/en/for-agents", "https://agentmaurice.ai/agent-guide/v1.json" ] } }, { "input": { "objective": "build_application", "client": "cursor", "instance_access": "no", "git_state": "clean", "environment": "staging", "locale": "en" }, "output": { "$schema": "agentmaurice.onboarding_doctor/v1", "status": "blocked", "objective": "build_application", "recommended_surface": "maurice_app_cli", "prerequisites": [ { "id": "instance", "status": "missing", "action": "Obtain AgentMaurice access and generate a single-use link in AgentMaurice OS." }, { "id": "git", "status": "met", "action": "Keep the repository clean through planning." }, { "id": "environment", "status": "met", "action": "Follow the policy for this environment." } ], "workflow": [ { "order": 1, "label": "Initialize the Application and add its Modules.", "command_template": "maurice app init --kind standard --json && maurice app add --json" }, { "order": 2, "label": "Prepare and review the Application plan.", "command_template": "maurice app plan --out app-plan.json --json" }, { "order": 3, "label": "Apply the approved plan and verify status.", "command_template": "maurice app apply --plan app-plan.json --plan-hash --tests auto --json" } ], "human_gates": [ "A distinct authenticated human must approve the exact plan before apply." ], "next_action": { "kind": "book_demo", "label": "Obtain AgentMaurice access before a runtime operation.", "href": "https://calendly.com/mikaelmorvan-agentmaurice/30min" }, "warnings": [ "Never request, display, or write a raw secret; use references only.", "Never infer an organization, environment, or Agent from a human name." ], "links": [ "https://agentmaurice.ai/en/for-agents", "https://agentmaurice.ai/agent-guide/v1.json" ] } }, { "input": { "objective": "operate_existing", "client": "claude_code", "instance_access": "unknown", "git_state": "unknown", "environment": "unknown", "locale": "fr" }, "output": { "$schema": "agentmaurice.onboarding_doctor/v1", "status": "needs_input", "objective": "operate_existing", "recommended_surface": "external_inception", "prerequisites": [ { "id": "instance", "status": "unknown", "action": "Confirmer qu’une instance et un Agent cible sont disponibles." }, { "id": "git", "status": "met", "action": "Aucun workspace Git n’est requis pour un diagnostic runtime read-only." }, { "id": "environment", "status": "unknown", "action": "Sélectionner explicitement l’environnement cible." } ], "workflow": [ { "order": 1, "label": "Confirmer le scope Agent depuis le bootstrap, sans inférer de cible.", "command_template": "inception_agent_scopes_list" }, { "order": 2, "label": "Lancer le Doctor compact ; utiliser full=true uniquement pour expliquer un problème.", "command_template": "inception_agent_doctor" }, { "order": 3, "label": "Lire les capabilities puis résoudre les tools runtime nécessaires.", "command_template": "inception_mcp_capabilities" } ], "human_gates": [], "next_action": { "kind": "complete_inputs", "label": "Compléter les prérequis inconnus avant toute mutation." }, "warnings": [ "Ne jamais demander, afficher ou écrire un secret brut ; utiliser uniquement des références.", "Ne jamais inférer organisation, environnement ou Agent depuis un nom humain." ], "links": [ "https://agentmaurice.ai/fr/for-agents", "https://agentmaurice.ai/agent-guide/v1.json" ] } } ], "pages": { "en": "https://agentmaurice.ai/en/for-agents", "fr": "https://agentmaurice.ai/fr/for-agents" }, "skill": { "entrypoint": "https://agentmaurice.ai/skill/agentmaurice/SKILL.md", "manifest": "https://agentmaurice.ai/skill/manifest.json", "editorial_source": "https://github.com/agentmaurice/skill" }, "security": { "read_only": true, "authenticated_runtime_doctor": "inception_agent_doctor", "raw_secrets_allowed": false, "agent_self_approval_allowed": false } }