For the complete documentation index, see llms.txt.
Smart Deploy

Documentation

Repository docs

This route renders the repository README and markdown under docs/ .

Source: docs/AI_ASSISTANCE.md

Rendered document

docs/AI_ASSISTANCE.md

Parsed server-side (markdown to HTML in the app). Same bytes you get from the checkout.

AI Assistance

Smart Deploy includes AI features to speed up production debugging. Each has a different data source and scope.

Feature comparison

FeatureWhereData sourceBest for
Deployment AgentHeader → AgentLive DB + runtime health via toolsQuick triage: list deploys, check health, recent failures
Analyze failureHistory / LogsFull run logs + failure classificationDeep dive on one failed deploy attempt
Improve scanScan resultsSD Artifacts feedback streamFix Railpack plan or build after scan/verification failure

Recommended debugging flow

1. Deployment Agent     →  "Why did my last deployment fail?"
2. Deployment History   →  full step logs for the failed run
3. Analyze failure      →  LLM explanation using complete logs
4. Improve scan         →  if build/plan issue (re-scan before redeploy)
5. Targeted guide       →  Build Failures, Health Checks, etc.

Deployment Agent

Read-only inspector. Uses up to 2 tool calls per question.

  • ✅ "Show my deployments", "is api healthy?", "what failed last time?"
  • ❌ Cannot deploy, rollback, or edit config

See Deployment Agent.

Analyze failure

Runs on a specific deployment history entry. Sends:

  • Failure code and classification
  • Step summary
  • Full logs from object storage (when available)

Use when the agent's log excerpts are not enough or you need a narrative root-cause analysis.

Available from:

  • Deployment History — on a failed entry
  • Deploy Logs — during or after a failed deploy

Improve scan

Sends failure context back to SD Artifacts to regenerate or repair the Railpack plan.

Use when:

  • Build verification failed
  • Railpack plan looks wrong
  • Deploy failed at Build with dependency or Dockerfile issues tied to scan output

Always review the updated scan and blueprint before redeploying.

Choosing the right tool

SituationStart with
"Is my app down?"Deployment Agent → Runtime Health tab
"Deploy failed 5 minutes ago"Deployment Agent → History → Analyze failure
"Build failed in CodeBuild"History logs → Build Failures → Improve scan if plan-related
"Wrong Node version"Railpack → Improve scan if auto-detection failed

Related