Codocly Client Documentation Retainer Setup (Onboarding)
A sequence with 7 steps: Import the client repository through 1-Click OAuth on GitHub, GitLab, or Bitbucket, or use ZIP upload for repos the client will not grant OAuth to.
By InnovaAI ResearchPublished
What are the steps?
Codocly Client Documentation Retainer Setup (Onboarding)
- 01
Import the client repository through 1-Click OAuth on GitHub, GitLab, or Bitbucket, or use ZIP upload for repos the client will not grant OAuth to
Confirm the auto-detected framework (Codocly recognizes 40+) matches the client's actual stack before generating anything; a misdetected framework corrupts the OpenAPI and C4 output downstream.
- 02
Run all four generation types on a staging branch: README, OpenAPI 3.1 reference, C4 architecture guide, and SRE runbook
Judge each output against what the client currently ships. If the runbook is thin because the repo has no deployment scripts, flag that as a scoping conversation rather than padding the doc.
- 03
Connect the Git webhook and open a test pull request to verify continuous sync fires on push
Watch the central dashboard sync health panel for the commit event. A webhook that fires on push but not on PR merge will silently stale the docs on client release branches.
- 04
Map the published docs site to the client's custom branded domain and confirm automated SSL issues cleanly
Screenshot the live domain with the client's branding for the onboarding record; this is the artifact that justifies the retainer line item at renewal.
- 05
Set role-based access so client engineers can view docs without consuming generation quota
The Team Plan (₹1,499/month, up to 100 docs per month) is the tier where role-based access matters; keep generation rights with agency staff only.
- 06
Record the plan tier, monthly doc allowance, and reset date in the client's delivery file
Pro Plan carries 40 docs per month at ₹799 per user; Team carries 100. Note which tier the client sits on so a heavy sprint does not exhaust the allowance mid-month.
- 07
Hand off the Codocly dashboard view and a one-page guide covering how docs regenerate on commit
Clients who understand that docs update on every push stop filing stale-documentation tickets, which is the main source of retainer friction.
More on Codocly
- StrategyWhy Codocly Turns Documentation Debt Into Agency Retainer Revenue
- ConceptCodocly Doc Volume Ladder
- Evaluation RuleCodocly Rule: Adopt Only When Git-Push Doc Sync Replaces a Recurring Client Deliverable
- Decision FrameworkCodocly: Buy vs Skip (Documentation Retainers for Dev Agency Clients)
- Failure PatternThe Codocly Quota Trap: Why Agencies Fail With Codocly on Multi-Repo Client Retainers
- Implementation BlueprintCodocly Technical Docs Retainer Build (6-8 days)
More for AI Code Tools
- Operating ProceduresLeadcode Client Workspace Isolation Setup (Onboarding)
- Operating ProceduresGenerativeIDE Client Onboarding with Write-Gate Audit (Delivery)
- Operating ProceduresEphemerals Branch Environment Lifecycle Management (Delivery)
- Operating Proceduresyume Client Session Recovery and Rollback (Delivery)