F
Pikablo Dev Forge
Pikablo workspace
Sign in
Documentation

Sample templates & prompts

Ready-to-use examples to help you configure Dev Forge for your team. Copy any template or prompt rule below and adapt it to your workflow.

Sample task templates

Templates define the structure of a generated GitHub task. Each template is a named set of sections that the AI fills in based on your raw notes.

๐Ÿ›

UI Bug

Use for visual defects, broken layouts, or interaction problems in the front end.

Sections
Problem Expected behavior Steps to reproduce Scope Technical notes
Example raw note
"The login button on mobile is hard to tap. It's too small and sits right next to the cancel link."
Generated title
๐Ÿ› [Mobile] Login button tap target too small โ€” overlaps cancel link
โš™๏ธ

Backend Task

Use for API changes, service refactors, or infrastructure work with clear acceptance criteria.

Sections
Context Required changes Acceptance criteria Technical notes
Example raw note
"The /invoices endpoint needs to support pagination. Right now it returns all records, which is slow."
Generated title
โš™๏ธ Add pagination to GET /invoices endpoint
โœจ

Feature Request

Use for new product capabilities described from a business or user perspective.

Sections
Business goal Expected flow Out of scope Constraints
Example raw note
"Users should be able to export their invoice history as a CSV file from the dashboard."
Generated title
โœจ Export invoice history as CSV from the user dashboard
โšก

Performance Task

Use when slow queries, high memory usage, or unacceptable response times need investigation.

Sections
Current metrics Target metrics Proposed approach Acceptance criteria
Example raw note
"The report generation page takes 12+ seconds to load for accounts with more than 500 invoices."
Generated title
โšก Reduce report generation load time for large accounts (>500 invoices)
๐Ÿ›ก๏ธ

Security & Compliance

Use for vulnerabilities, data-protection gaps, or regulatory compliance requirements.

Sections
Risk description Affected components Remediation steps Verification
Example raw note
"The password reset link stays valid for 7 days. That's too long โ€” should expire in 1 hour."
Generated title
๐Ÿ›ก๏ธ Reduce password reset link TTL from 7 days to 1 hour
๐Ÿ“–

Documentation & DX

Use for missing or outdated documentation, onboarding gaps, or developer experience improvements.

Sections
Current state What's missing Proposed content Audience
Example raw note
"New developers don't know how to set up the local environment. The README is outdated."
Generated title
๐Ÿ“– Update local development setup guide in README

Sample prompt rules

Prompt rules control how the AI model interprets your notes and which extra detail it adds. Combine a template with a prompt rule to tailor the output for your team's style.

1
๐Ÿ“

Base formatter

The default prompt rule for most teams. Converts raw developer notes into a clean, concise GitHub task. No speculative requirements, no padding โ€” just structured output that matches the selected template sections.

Sample instructions
You are a technical writer helping an engineering team write GitHub tasks. Convert the raw developer note below into a structured task. Use clear, concise language. Do not invent requirements that are not implied by the note. Output only the sections defined in the template โ€” nothing more.
Best for
General use UI bugs Backend tasks
2
๐Ÿค–

Copilot enhancer

Extends the base formatter with additional sections optimised for GitHub Copilot: edge cases, affected files/components, and implementation hints. Ideal for teams where Copilot Workspace or Copilot coding agent picks up tasks directly.

Sample instructions
You are a senior software engineer writing GitHub tasks optimised for GitHub Copilot. In addition to the standard template sections, add: โ€” Edge cases: 2โ€“4 non-obvious scenarios the implementation must handle. โ€” Acceptance criteria: 3โ€“6 verifiable, testable conditions. โ€” Implementation hints: brief pointers to affected files, classes or patterns (no full code). Keep all language technical and precise.
Best for
Copilot Workspace Complex features Refactors
3
๐Ÿข

Strict enterprise mode

Enforces formal language, numbered requirements, and explicit traceability fields. Avoids any speculative language or implementation suggestions. Suitable for regulated industries or teams with a formal change management process.

Sample instructions
You are a business analyst writing change requests for a regulated software system. Use formal, unambiguous language. Number all requirements (REQ-001, REQ-002 โ€ฆ). Do not suggest implementation approaches or reference internal code. Every requirement must be testable and independently verifiable. Output must be audit-ready and free of speculative content.
Best for
Regulated industries Change management Compliance teams
4
๐ŸŒ

Multilingual output

Accepts notes written in any language and always produces tasks in a single target language. Useful for distributed teams where developers write notes in their native language but the backlog must remain in English (or another standard language).

Sample instructions
The raw note may be written in any language. Regardless of the input language, always write the GitHub task in English. Translate faithfully โ€” do not summarise or omit any detail from the original note. Apply the selected template sections and keep the output concise and professional.
Best for
Distributed teams Non-English notes Multilingual orgs

Tips for great templates & prompts

Follow these guidelines to get the most consistent results from Dev Forge.

๐ŸŽฏ

Keep sections focused

Each template section should capture one distinct piece of information. Avoid combining "problem" and "solution" into a single section โ€” the AI works better with clear, separated concerns.

๐Ÿ“

3โ€“6 sections per template

Templates with fewer than 3 sections produce shallow tasks. More than 6 sections risk generating padded content when the raw note is brief. Aim for 4โ€“5 sections for everyday task types.

๐Ÿ”—

Pair templates with prompt rules

Assign a default prompt rule to each template to lock in a consistent style. For example, always pair the UI Bug template with Base formatter and Feature Request with Copilot enhancer.

๐Ÿšซ

Avoid vague instructions

Prompt rule instructions like "be helpful" or "write clearly" are too broad. Use explicit constraints: "do not suggest implementation approaches", "always include numbered acceptance criteria", "output only English regardless of input language".

๐Ÿงช

Test with real notes

Before setting a template or prompt rule as active, generate 3โ€“5 tasks using real raw notes from your team. Review the output for accuracy, completeness, and tone โ€” then adjust the instructions as needed.

๐Ÿ“Œ

Use one default prompt rule

Mark exactly one prompt rule as the default. This rule is pre-selected in the Composer and used as the fallback when a template does not specify its own rule. Additional rules remain available for manual selection.

Ready to set up your first template?

Sign in to Dev Forge and create your templates, prompt rules and repo routing in minutes.