#blockchain-template.md
Version: 1.0.0
Target Models
- GPT-6 Astra
- GPT-5.6
- GPT-5.5
- GPT-5 Family
- Future GPT Models
#Purpose
This template provides complete engineering context for designing production-ready blockchain applications that solve real business problems through decentralized systems, smart contracts, cryptographic security, programmable assets, trust minimization, and scalable distributed infrastructure.
It is intended to organize business objectives, blockchain architecture, smart contract design, token economics, user experience, security requirements, operational workflows, governance, and long-term ecosystem evolution into one structured engineering specification.
The objective is not building software on a blockchain.
The objective is engineering decentralized products that provide measurable advantages over traditional architectures while remaining secure, scalable, maintainable, and economically sustainable.
#Core Philosophy
Understand the Business
↓
Validate Blockchain Necessity
↓
Design Trust Model
↓
Define Digital Assets
↓
Build Secure Protocols
↓
Create Sustainable Economics
↓
Operate Transparently
↓
Continuously Improve
Blockchain should exist because decentralization creates measurable business value—not because it is technologically interesting.
#Product Overview
Clearly define
Product Name
Category
Business Problem
Target Audience
Business Goals
Primary Blockchain Value
Expected Business Outcomes
Long-Term Vision
The overview should explain why blockchain is the appropriate engineering solution.
#Business Context
Define
Target Customers
Customer Segments
Business Model
Revenue Strategy
Market Position
Competitive Landscape
Growth Strategy
Success Metrics
Every blockchain component should support measurable business objectives.
#Decentralization Analysis
Clearly define
Current Centralized Process
Trust Problems
Ownership Problems
Transparency Requirements
Verification Requirements
Automation Opportunities
Business Risks
Expected Improvements
Only decentralize the components that genuinely benefit from decentralization.
#Blockchain Architecture
Define
Blockchain Network
Layer Architecture
Execution Layer
Settlement Layer
Storage Strategy
Identity Model
Cross-Chain Strategy
Future Evolution
Architecture should prioritize reliability before complexity.
#User Personas
Describe
End Users
Wallet Holders
Developers
Validators
Administrators
DAO Members
Enterprise Customers
Protocol Operators
Every blockchain interaction should simplify user participation.
#Core Features
Identify
Wallet Integration
Authentication
Smart Contracts
Asset Management
Transactions
Governance
Marketplace
Staking
Voting
Rewards
Identity
Analytics
Notifications
Administration
Every feature should create measurable business value.
#Smart Contract Architecture
Design
Contract Responsibilities
Business Logic
Permission Model
Upgrade Strategy
Access Control
Data Structures
Events
Interactions
Recovery Strategy
Smart contracts should remain minimal, deterministic, auditable, and secure.
#Digital Asset Strategy
Define
Native Token
Stable Assets
NFT Assets
Real-World Assets
Governance Tokens
Utility Tokens
Reward Assets
Ownership Model
Assets should represent genuine business value rather than speculation.
#Token Economics
Design
Supply Model
Distribution
Emission Strategy
Utility
Incentives
Treasury
Governance
Long-Term Sustainability
Token economics should reward ecosystem growth rather than short-term speculation.
#Transaction Flow
Describe
User Action
↓
Wallet Approval
↓
Transaction Validation
↓
Contract Execution
↓
State Update
↓
Event Emission
↓
Confirmation
↓
Business Completion
Every transaction should have a predictable lifecycle.
#Wallet Experience
Define
Wallet Connection
Authentication
Signing
Network Selection
Transaction Preview
Approval Flow
Error Handling
Session Management
Wallet interactions should minimize user uncertainty.
#Security Requirements
Define
Contract Audits
Access Control
Permission Validation
Signature Verification
Input Validation
Oracle Security
Key Management
Emergency Procedures
Security should be designed before implementation begins.
#Data Strategy
Define
On-Chain Data
Off-Chain Data
Metadata
Storage Strategy
Indexing
Synchronization
Retention Policies
Privacy Requirements
Store on-chain only the information that benefits from immutability.
#Governance Strategy
Design
Protocol Governance
Voting
Proposal Lifecycle
Treasury Management
Community Participation
Permission Changes
Upgrade Governance
Dispute Resolution
Governance should balance decentralization with operational effectiveness.
#Oracle Strategy
Define
External Data Sources
Verification Rules
Fallback Sources
Data Validation
Update Frequency
Failure Recovery
Monitoring
Security Controls
External data should be independently verifiable whenever possible.
#Scalability Strategy
Define
Layer 2
Rollups
Sidechains
Batch Processing
Caching
Indexing
Cross-Chain Communication
Performance Optimization
Scalability should preserve decentralization whenever practical.
#Observability
Define
Transaction Monitoring
Smart Contract Events
System Metrics
Infrastructure Monitoring
Wallet Analytics
Network Health
Security Alerts
Operational Dashboards
Distributed systems require complete operational visibility.
#Deployment Strategy
Define
Development
Testing
Testnet Deployment
Security Review
Audit Process
Mainnet Deployment
Upgrade Strategy
Rollback Procedures
Deployment should minimize protocol risk.
#Business Metrics
Measure
Active Wallets
Daily Transactions
Transaction Success Rate
Protocol Revenue
Treasury Growth
Liquidity
User Retention
Governance Participation
Infrastructure Cost
Business Growth
Only measure metrics that influence ecosystem health.
#Engineering Constraints
Always respect
Business Objectives
Security
Reliability
Transparency
Maintainability
Scalability
Privacy
Regulatory Requirements
Operational Simplicity
Engineering discipline should always take priority over ecosystem hype.
#Deliverables
The generated blockchain product specification should include
- Product Overview
- Business Context
- Decentralization Analysis
- Blockchain Architecture
- User Personas
- Core Features
- Smart Contract Architecture
- Digital Asset Strategy
- Token Economics
- Transaction Flow
- Wallet Experience
- Security Requirements
- Data Strategy
- Governance Strategy
- Oracle Strategy
- Scalability Strategy
- Deployment Plan
- Observability
- Business Metrics
- Long-Term Evolution Strategy
Every section should contribute toward building a production-ready decentralized product rather than a blockchain demonstration.
#Definition of Done
A blockchain product specification is considered complete when business objectives, decentralization requirements, blockchain architecture, smart contract responsibilities, digital asset strategy, token economics, governance model, security controls, transaction workflows, wallet experience, scalability strategy, deployment process, observability, operational requirements, and long-term evolution plans have been documented with sufficient clarity that engineering teams can confidently design, build, audit, deploy, operate, and continuously improve the protocol with minimal ambiguity.
Exceptional blockchain products are not measured by transaction volume, token price, or protocol complexity.
They are measured by how effectively they solve meaningful business problems, establish trustworthy decentralized systems, protect digital ownership, enable sustainable ecosystem growth, support reliable engineering execution, and continuously deliver measurable value throughout the lifetime of the platform.