Skip to content

Tool Reference

architect-mcp exposes a small default core surface and an explicit advanced surface. The default public story is the agent work gate: clarify before edits, constrain the plan, review drift, and require verification evidence.

Historical V-labels remain in tool, script, test, and compatibility file identifiers. They are internal compatibility references, not public product framing.

Surfaces

  • Core: the eight work-gate tools listed in the Core Work Gate section.
  • Advanced: the core tools plus the compatibility, maturity, governance, repo-quality, stack-pack, MCP, and eval tools listed below.

Core Work Gate

The default public surface for clarifying work, constraining edits, reviewing drift, and checking final evidence.

ToolPurpose
grill_mePressure-test the request before planning or editing.
create_pre_edit_contractTurn clarified intent into an explicit edit contract.
review_build_planReview the implementation plan against the agreed contract.
review_proposed_file_planCheck file paths and ownership before edits start.
review_repo_structureReview repository structure from supplied file summaries.
review_implementation_against_contractCompare changed files and verification against the pre-edit contract.
review_agent_final_responseCheck the final response for evidence, receipts, honesty, and not-done disclosure.
review_agent_sessionCombine intent, contract, drift, receipts, memory, and final-response checks into one session review.

Stack Packs And Standards

Stack-pack loading, source ingestion, promotion, standards comparison, and policy set tuning.

ToolPurpose
list_stack_packsList Stack Packs.
validate_stack_packsValidate Stack Packs.
list_foundation_packsList Foundation Packs.
validate_foundation_packsValidate Foundation Packs.
stack_pack_expansion_strategyStack Pack Expansion Strategy.
discover_llms_sourcesDiscover Llms Sources.
fetch_llms_sourceFetch Llms Source.
ingest_llms_txtIngest Llms Txt.
list_ingested_llms_sourcesList Ingested Llms Sources.
derive_stack_pack_from_llms_sourceDerive Stack Pack From Llms Source.
propose_stack_pack_rulesPropose Stack Pack Rules.
review_stack_pack_candidateReview Stack Pack Candidate.
promote_stack_pack_candidatePromote Stack Pack Candidate.
promote_stack_pack_to_filesPromote Stack Pack To Files.
analyze_stack_pack_conflictsAnalyze Stack Pack Conflicts.
diff_stack_pack_versionsDiff Stack Pack Versions.
score_stack_packsScore Stack Packs.
stack_pack_coverage_matrixStack Pack Coverage Matrix.
resolve_standards_profileResolve Standards Profile.
analyze_standards_conflictsAnalyze Standards Conflicts.
compare_standards_profilesCompare Standards Profiles.
review_standards_refactorReview Standards Refactor.
minimize_policy_setMinimize Policy Set.
calibrate_rule_impactCalibrate Rule Impact.

Repo Intake And Scaffolding

Repo profile selection, intake, artifact generation, scaffold planning, and repo-readiness checks.

ToolPurpose
list_repo_profilesList Repo Profiles.
get_repo_profileGet Repo Profile.
infer_repo_layoutInfer Repo Layout.
forge_foundry_previewsGenerate preview-only PR, issue, exception, no-op, and human-question artifacts from public-safe Foundry decisions without mutating repositories.
route_foundry_decisionsRoute scored Foundry assessments into public-safe ledger entries without mutating repositories.
score_foundry_actionabilityScore normalized Foundry evidence for PR-preview suitability, human review, exceptions, and no-op candidates.
normalize_foundry_evidenceNormalize findings, verification, repo constitution, coverage, and suppression candidates into public-safe Foundry evidence.
derive_repo_constitutionDerive repo instructions, PR templates, CI, release, package, and recent-PR style signals from supplied evidence.
derive_local_repo_constitutionLocal-only scan that derives a public-safe repo constitution without mutating files.
start_project_intakeStart Project Intake.
grill_project_briefGrill Project Brief.
continue_grill_meContinue Grill Me.
generate_architecture_contractGenerate Architecture Contract.
generate_agent_instructionsGenerate Agent Instructions.
generate_agents_mdGenerate Agents Md.
generate_cursor_rulesGenerate Cursor Rules.
generate_repo_artifactsGenerate Repo Artifacts.
generate_repo_scaffold_planGenerate Repo Scaffold Plan.
review_local_workspaceReview Local Workspace.
create_review_baselineCreate Review Baseline.
validate_architecture_contractValidate Architecture Contract.
validate_repo_artifactsValidate Repo Artifacts.
self_review_architect_mcpSelf Review Architect Mcp.
diff_architecture_contractsDiff Architecture Contracts.
mcp_readiness_reportMcp Readiness Report.
score_repo_profile_fitScore Repo Profile Fit.

Contract And Session Review

Ambiguity classification, implementation intent, contract lifecycle review, and session continuity checks.

ToolPurpose
interpret_implementation_intentInterpret Implementation Intent.
classify_ambiguity_riskClassify Ambiguity Risk.
record_assumptionRecord Assumption.
load_triggered_stack_guidanceLoad Triggered Stack Guidance.
audit_work_gate_completenessReport whether direct MCP workflows supplied complete, fresh, ordered work-gate evidence.
create_work_gate_sequence_receiptCreate a public-safe direct-client receipt for gate order, confirmed inputs, evidence, and freshness.
explain_review_findingsExplain Review Findings.
simulate_policy_gateSimulate Policy Gate.
review_contract_lifecycleReview Contract Lifecycle.
summarize_session_continuitySummarize Session Continuity.
cluster_review_findingsCluster Review Findings.
generate_local_report_artifactGenerate Local Report Artifact.

Memory, Skills, And MCP Integrations

Advisory memory, skill catalog review, MCP security review, MCP catalog recommendations, and guarded install plans.

ToolPurpose
extract_harness_memoryExtract Harness Memory.
apply_harness_memoryApply Harness Memory.
review_memory_relevanceReview Memory Relevance.
list_mcp_server_catalogList the curated MCP server catalog.
recommend_mcp_serversRecommend MCP servers only after provider and boundary checks.
create_mcp_install_planCreate a dry-run MCP client configuration plan.
review_mcp_install_planReview an MCP install plan for unsafe config, secrets, and unpinned packages.
apply_mcp_install_planLocal-only dry-run/apply tool for project-local MCP client config.
list_skill_catalogList Skill Catalog.
recommend_skills_for_projectRecommend Skills For Project.
review_supplied_skillsReview Supplied Skills.
review_mcp_config_securityReview Mcp Config Security.
scan_mcp_config_filesScan Mcp Config Files.
list_client_integration_recipesList Client Integration Recipes.
audit_hosted_tool_policyAudit Hosted Tool Policy.

Eval Harnesses And Repo Quality

Deterministic evals, generated repo quality checks, and regression coverage analysis.

ToolPurpose
run_v3_eval_harnessRun V3 Eval Harness.
score_agent_artifactsScore Agent Artifacts.
run_v5_eval_harnessRun V5 Eval Harness.
run_v6_eval_harnessRun V6 Eval Harness.
run_v7_eval_harnessRun V7 Eval Harness.
run_v8_eval_harnessRun V8 Eval Harness.
run_v9_eval_harnessRun V9 Eval Harness.
run_v10_eval_harnessRun V10 Eval Harness.
analyze_regression_coverageAnalyze Regression Coverage.
evaluate_scenario_acceptanceEvaluate Scenario Acceptance.
build_quality_requirements_profileBuild Quality Requirements Profile.
evaluate_repo_plan_qualityEvaluate Repo Plan Quality.
audit_generated_repo_qualityAudit Generated Repo Quality.
suggest_quality_followup_questionsSuggest Quality Followup Questions.
run_repo_quality_eval_scenariosRun Repo Quality Eval Scenarios.
run_foundry_eval_corpusRun deterministic offline Foundry eval scenarios over large and small repo summaries without network access or mutation.

Governance And Operating Model

Policy bundles, governance artifacts, orchestration planning, scenario routing, and productization boundaries.

ToolPurpose
list_policy_bundlesList Policy Bundles.
validate_policy_bundlesValidate Policy Bundles.
preview_policy_bundlePreview Policy Bundle.
review_pattern_cardReview Pattern Card.
preview_pattern_cardPreview Pattern Card.
create_architecture_strategy_mapCreate Architecture Strategy Map.
preview_change_what_ifPreview Change What If.
diagnose_agent_behaviorDiagnose Agent Behavior.
draft_rule_candidateDraft Rule Candidate.
compare_review_trendsCompare Review Trends.
render_governance_packRender Governance Pack.
select_review_playbookSelect Review Playbook.
review_playbook_conformanceReview Playbook Conformance.
check_agent_collaboration_planCheck Agent Collaboration Plan.
run_failure_mode_drillsRun Failure Mode Drills.
review_documentation_intelligenceReview Documentation Intelligence.
select_local_orchestration_recipeSelect Local Orchestration Recipe.
normalize_mcp_resultNormalize Mcp Result.
plan_context_budgetPlan Context Budget.
route_evidenceRoute Evidence.
create_local_dry_run_planCreate Local Dry Run Plan.
review_tool_loop_qualityReview Tool Loop Quality.
get_v10_productization_blueprintGet V10 Productization Blueprint.
create_v10_implementation_slice_planCreate V10 Implementation Slice Plan.
plan_primer_dashboardPlan Primer Dashboard.
validate_v10_productization_boundaryValidate V10 Productization Boundary.

Hosted Policy

Hosted mode exposes only hosted-safe tools. Local-only tools are excluded from hosted HTTP registration even when the advanced surface is requested.

Local-only tools:

  • promote_stack_pack_to_files
  • review_local_workspace
  • derive_local_repo_constitution
  • scan_mcp_config_files
  • apply_mcp_install_plan

Future-adapter tools currently return stateless proposals. Durable storage waits for an explicit adapter:

  • extract_harness_memory
  • apply_harness_memory
  • review_memory_relevance

Unknown tools classify as unknown and must never be treated as hosted-safe.

Released under the MIT License.