{"id":34758075,"url":"https://github.com/marco-souza/tremtec","last_synced_at":"2026-05-25T17:02:36.525Z","repository":{"id":325652107,"uuid":"834309195","full_name":"marco-souza/tremtec","owner":"marco-souza","description":"TremTec site","archived":false,"fork":false,"pushed_at":"2026-04-09T21:34:38.000Z","size":5452,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T22:21:46.622Z","etag":null,"topics":["astro","bun","cloudflare","opencode","pulumi","tremtec"],"latest_commit_sha":null,"homepage":"https://tremtec.com","language":"Astro","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marco-souza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-07-26T22:51:41.000Z","updated_at":"2026-04-09T21:34:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/marco-souza/tremtec","commit_stats":null,"previous_names":["marco-souza/tremtec"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marco-souza/tremtec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marco-souza%2Ftremtec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marco-souza%2Ftremtec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marco-souza%2Ftremtec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marco-souza%2Ftremtec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marco-souza","download_url":"https://codeload.github.com/marco-souza/tremtec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marco-souza%2Ftremtec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33484522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T14:31:05.219Z","status":"ssl_error","status_checked_at":"2026-05-25T14:31:02.878Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astro","bun","cloudflare","opencode","pulumi","tremtec"],"created_at":"2025-12-25T05:48:02.255Z","updated_at":"2026-05-25T17:02:36.520Z","avatar_url":"https://github.com/marco-souza.png","language":"Astro","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TremTec\n\nTremTec is a strategic engineering consulting and outsourcing platform that helps high-growth companies accelerate their development process and scale high-performance technical teams.\n\n## 🎯 Mission\n\n\u003e **\"Build trustworthy software faster. We help your team master AI—not replace humans with it—and create SDLCs that actually sustain.\"**\n\nTremTec helps high-growth engineering teams accelerate their development velocity **without sacrificing quality, security, or sustainability**. We believe:\n\n- **AI is a tool**, not a replacement for human expertise\n- **Humans come first** - software should serve people, not the other way around\n- **Speed must be sustainable** - velocity that burns out teams is velocity that fails\n- **Trust is earned through reproducibility** - auditable, documented processes you can rely on\n\n## 🎯 Core Services\n\nTremTec offers three core services:\n\n1. **Implementation**: We implement reproducible SDLCs that combine AI and human expertise. Your team learns patterns you can sustain independently.\n2. **Diagnostics**: Deep analysis reveals where you're actually slow—and it's rarely what you think. Clear roadmap to sustainable velocity.\n3. **Mentoring**: Ongoing coaching that teaches your team to work symbiotically with AI and modern tools. From reactive to proactive. From survival to mastery.\n\n## 🏗️ Project Structure\n\n```\ntremtec/\n├── src/                    # Frontend \u0026 Backend Application\n│   ├── domain/             # Business entities \u0026 services (Clean Architecture)\n│   │   ├── auth/           # Authentication domain\n│   │   ├── user/           # User domain\n│   │   └── shared/         # Shared types \u0026 services\n│   ├── server/             # Hono backend routes \u0026 handlers\n│   ├── pages/              # Astro pages (SSR)\n│   ├── ui/                 # SolidJS components\n│   ├── lib/                # Utilities, API clients\n│   ├── middleware.ts       # Request middleware\n│   └── config.ts           # Environment configuration\n├── .agents/                # AI Agent Definitions\n│   ├── skills/             # Agent capabilities (CPO, Tech Lead, Dev, etc.)\n│   └── rules/              # Workflow definitions (new product, feature, bug)\n├── infra/                  # Pulumi IaC (Cloudflare Workers deployment)\n├── docs/                   # Project documentation\n│   └── agent_workflows.md  # Detailed workflow diagrams\n└── package.json            # Dependencies\n```\n\n## 🚀 Tech Stack\n\n- **Frontend**: Astro + SolidJS + TailwindCSS + DaisyUI\n- **Backend**: Hono + Zod + TypeScript\n- **Infrastructure**: Pulumi + Cloudflare Workers\n- **Testing**: Vitest + Solid Testing Library\n- **Code Quality**: Biome (lint/format)\n- **Auth**: GitHub OAuth, Google OAuth\n\n## 🏃 Getting Started\n\n### Prerequisites\n\n- Bun (package manager)\n- Node.js 18+\n- Cloudflare account (for deployment)\n\n### Installation\n\n```bash\n# Install dependencies\nmise install\nbun install\n\n# Set up environment variables\ncp .env.example .env\n\n# you can also use mise decrypt/encrypt to manage .env\nmise decrypt\n\n# Start development server\nbun run dev\n```\n\n### Available Commands\n\n```bash\nbun run dev        # Start Astro dev server (localhost:3000)\nbun run build      # Build production assets\nbun run lint       # Run Biome linter + Astro type check\nbun run fix        # Auto-fix linting issues\nbun run test       # Run Vitest unit tests\nbun run test:ui    # Run Vitest with UI dashboard\nbun w build        # Build Cloudflare Worker (wrangler)\nbun w dev          # Test Worker locally\n```\n\n## 🤖 AI Agents \u0026 Workflows\n\n### Core Workflows\n\n1. **New Product** (Zero to One)\n   - CPO generates PRD and MVP scope\n   - Tech Lead designs architecture\n   - Dev agents build frontend/backend in parallel\n   - Infrastructure deployed to Cloudflare\n\n2. **New Feature** (Iteration)\n   - Requirement analysis\n   - Architecture review\n   - Implementation with code review\n   - Automated deployment\n\n3. **Bug Fix** (Maintenance)\n   - Root cause analysis\n   - Fix implementation\n   - Regression testing\n   - Hotfix deployment\n\nSee [docs/agent_workflows.md](docs/agent_workflows.md) for detailed sequence diagrams.\n\n## 🏛️ Architecture Patterns\n\n### Clean Architecture\n\n- **Domain Layer** (`src/domain/`): Pure entities and business rules\n  - Simple data structures (Zod schemas for validation)\n  - No framework dependencies\n  - Tests co-located with modules\n- **Service Layer** (`src/domain/*/service.ts`): Use cases and business logic\n  - Encapsulates operations on entities\n  - Stateless functions, no HTTP/DB dependencies (via injection)\n- **Controller Layer** (`src/server/`): HTTP handlers\n  - Routes and request/response handling\n  - Delegates all business logic to services\n\n### Full-Stack TypeScript\n\n- Type-safe end-to-end: database → API → frontend\n- Zod schemas shared between server \u0026 client\n- TypeScript strict mode enabled\n\n### Authentication\n\n- OAuth 2.0 with GitHub \u0026 Google providers\n- Session-based auth with HTTP-only cookies\n- Protected routes via middleware\n\n## 🚀 Deployment\n\nInfrastructure is managed via Pulumi IaC:\n\n```bash\n# Deploy to production (requires Cloudflare credentials)\ncd infra\nbun run pulumi up --stack prod\n```\n\nFeatures:\n\n- Auto-deploys on git commits\n- Custom domain support (tremtec.com)\n- WWW → apex domain redirect\n- Observability enabled (tracing, logging)\n\n## 📝 Contributing\n\n### Code Style\n\n- Follow Biome formatting rules (`bun run fix`)\n- Use TypeScript strict mode\n- Write tests for domain logic\n- Use kebab-case for files, PascalCase for components\n\n### Adding Features\n\n1. Start with domain entities (`src/domain/`)\n2. Add service logic (`src/domain/*/service.ts`)\n3. Add controller routes (`src/server/`)\n4. Create UI components (`src/ui/`)\n5. Add tests and run `bun run lint`\n6. Push to GitHub (auto-deploys)\n\n### Documentation\n\n- Update AGENTS.md for architectural patterns\n- Add inline comments for non-obvious logic\n- Reference feature docs in commits\n\n## 📚 Key Documentation\n\n- [AGENTS.md](AGENTS.md) - Agent definitions \u0026 technical guidelines\n- [docs/agent_workflows.md](docs/agent_workflows.md) - Workflow diagrams\n- [.agents/rules/workflows.md](.agents/rules/workflows.md) - Workflow state machines\n\n## 🔐 Environment Variables\n\nRequired for development:\n\n- `GITHUB_ID` - GitHub OAuth app ID\n- `GITHUB_SECRET` - GitHub OAuth secret\n- `GOOGLE_ID` - Google OAuth client ID\n- `GOOGLE_SECRET` - Google OAuth secret\n- `BASE_URL` - Application URL (auto-set in infra)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 👥 Authors\n\nBuilt with AI Agents orchestrated by TremTec\n\n---\n\n**Questions?** Check the docs or open an issue on GitHub.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarco-souza%2Ftremtec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarco-souza%2Ftremtec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarco-souza%2Ftremtec/lists"}