Development Philosophy

TOOLING-FIRST: Fix the source, not the symptom

Every problem is an opportunity to improve the tooling layer. Traditional development follows a pattern of quick fixes leading to technical debt. At Predictiv, we take a different approach: **Problem → Check Documentation → Fix Generator/Tool → Problem Solved Forever**.

Every solution strengthens the platform. Today's fix becomes tomorrow's capability.

The Three-Step Investigation Order

When encountering any problem, we follow a mandatory sequence:

**Documentation FIRST**: Before writing any code, check if the problem has been solved. We maintain comprehensive documentation including development patterns, deployment toolkits, and lessons learned. Why? We solved this before. Don't rediscover.

**Tooling Scripts SECOND**: Fix the source (generators/scripts), not the output (database/XML). Generators are the source of truth. Fixing outputs creates drift and breaks repeatability.

**Database/Code THIRD**: Only touch database or code directly when documentation and tooling options are exhausted, or when implementing genuinely new functionality.

Work Clean

Archive directories are a code smell. They accumulate cruft nobody reads. Git history is the archive.

When you discover a better pattern: (1) Update the tooling to implement it, (2) Update documentation to explain it, (3) Delete superseded approaches, (4) Document what was removed in commit message.

Agent-Based Development

Development is supported by 20+ specialized AI agents, each expert in their domain—from solutions architecture to React development, from AI/ML to DevOps.

Each agent embodies TOOLING-FIRST: Check documentation before proposing solutions, use existing tools rather than creating new ones, fix generators not outputs, and document patterns for future reuse.

This isn't just tooling—it's **institutional knowledge encoded into the development process**.

Quality Standards

**Zero Warnings Policy**: Warnings indicate sub-optimal code. Every warning must be investigated, fixed, or documented if unfixable. Goal: All Predictiv module code compiles with zero warnings.

**Be a Partner, Not a Praise Singer**: Question decisions that seem suboptimal. Push back when best practices are violated. Offer alternatives based on expertise. Honest feedback is valuable. False agreement is harmful.

Tool Composability

Tools must be combinable for complex workflows: Single responsibility, standard interfaces, pipeline-friendly, and idempotent. Complex problems are solved by combining simple, reliable tools.

Repeatability

Deployments work the same every time through automated tooling and generators.

Knowledge Capture

Solutions become institutional memory, documented and encoded in tools.

Quality Accumulation

Each project improves the platform, strengthening the tooling layer.

Sustainable Development

Less technical debt over time through systematic improvement.

Why Predictiv

Documentation First

We check documentation before proposing solutions. Knowledge is institutional, not individual.

Fix Generators, Not Outputs

We modify the source of truth (generators/scripts), not the generated outputs.

Agent-Driven Development

20+ specialized AI agents embody best practices and domain expertise.

Zero Warnings Policy

Quality is non-negotiable. Every warning is investigated and resolved.

Ready to Transform Your ERP Development?

Experience the power of TOOLING-FIRST development with Predictiv ERP.