jp-architecture
Design the architecture for a Juspay payment integration — collaborative, step-by-step decisions that ground the integration in real Juspay docs and produce a consistent implementation guide. Use when the user says "design the Juspay integration", "create integration architecture", or after jp-prd to turn the PRD into a technical design.
How do I install this agent skill?
npx skills add https://github.com/juspay/merchant-skills --skill jp-architectureIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The jp-architecture skill is a structured workflow for designing Juspay payment integrations. It guides users through architectural decisions grounded in official Juspay documentation and generates implementation checklists. The skill demonstrates secure development practices, particularly concerning secret management and the use of scoped telemetry. No malicious patterns or security risks were identified.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 2 issues
What does this agent skill do?
JP Architecture Workflow
Goal: Turn a Juspay integration PRD into comprehensive, doc-grounded architecture decisions through collaborative step-by-step discovery, so that jp-executor (and any AI agent) implements consistently.
Your Role: You are an integration architect collaborating with a peer. You bring structured thinking and Juspay integration knowledge; the user brings domain expertise and product context. Decisions are made together and grounded in the fetched docs — not asserted from memory.
Conventions
- Bare paths (e.g.
steps/step-01-init.md) resolve from the skill root. {skill-root}resolves to this skill's installed directory.{project-root}-prefixed paths resolve from the project working directory.- Doc-grounding. Juspay product/API/SDK facts come from
docs-mcp-server(seereferences/juspay-docs-mcp.md) or the user — never training data. Cite source URLs in the architecture document. - Product catalog.
products/is a non-authoritative orientation catalog (per product: What it is / When to recommend / Key concepts / Intent signals). Use it for the chosen product's concepts/platforms; confirm slug/shape/platforms againstdocs-mcp. Seeproducts/README.md. - Live merchant data (
juspay-mcp). Optional and auth-guarded — seereferences/juspay-mcp.md. Reuse the mode + values the PRD/.decision-log.mdalready recorded; only run the access flow (ask access → log in or manual Q&A) for read data this skill newly needs (webhook/general settings, integration stages). Never block. Credential provisioning stays injp-executor; secrets never enter this document. - Workspace.
{doc_workspace}is{project-root}/docs/juspay/(create if absent). This skill readsprd.md(fromjp-prd) there and writesarchitecture.mdandtask-checklist.mdthere.jp-executorreads all of them. In split-repo runs it may also read an incominghandoff-<this_side>.md; the portablehandoff-<other_side>.mdis produced later byjp-executor. - No config of our own. No settings file, no language/name resolution. The skill reads only the user's inputs (their repo, docs they point to) and the artifacts in
{doc_workspace}. - Production enforced. Always design for the production environment. Don't ask which environment to use or present sandbox vs production as a choice; switch to a non-production environment only if the user explicitly and unpromptedly requests it (see
steps/step-04-decisions.md). - Split-repo aware. FE and BE may live in separate repos. Reuse the
topology/this_side/other_siderecorded byjp-prd; design the full integration but partition the task-checklist bysideand author a Cross-Side Contract for the seam. If an incominghandoff-<this_side>.mdexists, lock the contract from it. Seereferences/split-integration.md. - Stage tracking. This skill owns the
architecturefunnel phase —startedinsteps/step-01-init.md,completedinsteps/step-09-complete.md, viajuspay_track_integration_stage(fire-and-forget, never blocking). Seereferences/integration-stage-tracking.md.
WORKFLOW ARCHITECTURE
This uses micro-file architecture for disciplined execution:
- Each step is a self-contained file with embedded rules.
- Sequential progression with user control at each step.
- Document state tracked in frontmatter (
stepsCompleted). - Append-only document building through conversation.
- You NEVER proceed to a step file if the current step file indicates the user must approve and indicate continuation.
On Activation
Briefly orient the user: this skill turns a Juspay integration PRD into an architecture design. Mention that at any decision they can ask to explore deeper (inline advanced elicitation) or weigh it from multiple perspectives (security / ops / developer-experience). Prefer the product's native choice/select/question UI whenever the runtime provides it; do not simulate menus with hand-rolled A / P / C text when native UI is available. There is no settings file and no scripts to run.
Execution
Read fully and follow: ./steps/step-01-init.md to begin the workflow.
Note: Input document discovery (the jp-prd PRD is required) and all initialization protocols are handled in step-01-init.md.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/juspay/merchant-skills/jp-architecture">View jp-architecture on skillZs</a>