Admin Guide

Admin Configuration & Context

Tailor StoryCraft’s AI behavior to match your team’s exact standards, terminology, and issue structures.

NAV
Access the Admin Portal via Apps → StoryCraft Administration
⚙️

1. Issue Configuration & Mapping

Map customized templates and "Golden Examples" to specific Jira issue types (User Stories, Bugs, Epics) so generated content seamlessly follows your team's tone and formatting rules.

Template Mapping

Custom Specs

Define structural requirements (e.g., Acceptance Criteria in Gherkin format, Edge Cases, Technical Constraints) for each issue type.

  • Assign distinct templates for Stories, Bugs, and Tasks
  • Auto-generate new templates using built-in AI prompting

Golden Examples

Quality Anchor

Provide "gold standard" ticket examples. StoryCraft uses these as zero-shot reference points to mimic your best documentation style.

  • Ensures consistent tone across all POs and Product Managers
  • Prevents incomplete criteria by modeling high-quality tickets
📚

2. Global Domain Context & Glossary

Provide background knowledge about your application, domain terminology, and architecture. This prevents the AI from making generic assumptions.

💡

Pro Tip: The richer your Global Context, the fewer notes developers need to write. If the AI already understands your internal system names (e.g., "Billing-V2 Service"), mentioning the name alone is enough to produce accurate ticket specs.

Recommended Elements to Include in Context:

System Architecture

Overview of microservices, databases, and communication protocols.

Domain Glossary

Company-specific terminology, acronyms, and business logic terms.

User Personas

Target roles, user permissions, and primary user journey goals.

Technical Constraints

Security policies, non-functional requirements, and API standards.

📈

3. Usage Analytics

Gain visibility into feature adoption and track how StoryCraft is utilized across your projects.

Tracked Metric

Feature Frequency

Monitor usage rates for Generation, Iteration, and Auditing functions.

Tracked Metric

Team Adoption

Identify which teams leverage AI ticket generation most actively.

Tracked Metric

Optimization Opportunities

Discover which templates or features require additional team guidance.