JobIT es una plataforma fullstack modular de empleo tecnologico. Su objetivo es ayudar a profesionales tech a gestionar mejor su busqueda laboral, preparar su perfil y conectar con oportunidades relevantes.
El repositorio se encuentra en fase documental inicial. En esta etapa no se implementa frontend, backend, base de datos, Docker, autenticacion, CI/CD ni ninguna configuracion tecnica.
JobIT se plantea como una plataforma evolutiva con modulos separados por responsabilidad:
- Experiencia de candidatos.
- Gestion de perfil profesional.
- Busqueda y seguimiento de ofertas.
- Preparacion de candidaturas.
- Futuras herramientas para recruiters y empresas.
- Futuras capacidades de analitica e inteligencia asistida.
La primera version se limita a validar el nucleo candidate-first antes de ampliar el alcance.
El MVP inicial sera candidate-first. Debe centrarse en resolver necesidades reales de candidatos tech sin abrir todavia funcionalidades avanzadas.
Alcance previsto del MVP:
- Registro conceptual de candidatos y perfil profesional.
- Gestion basica de informacion laboral, skills y preferencias.
- Exploracion o gestion inicial de oportunidades.
- Seguimiento simple del proceso de candidatura.
- Base funcional preparada para crecer por modulos.
Todo el alcance funcional debera definirse mediante especificaciones antes de implementarse.
Queda fuera del MVP inicial:
- Frontend, backend, base de datos o infraestructura durante la fase documental inicial.
- Modulo recruiter completo.
- IA avanzada o automatizaciones complejas.
- Monetizacion.
- Comunidad real o red social.
- Aplicacion movil.
- Integraciones externas no imprescindibles.
- CI/CD, despliegue, Docker o configuracion de produccion.
El stack definitivo se decidira en sprints tecnicos posteriores. Como orientacion inicial, el proyecto preve:
- Frontend: Next.js + TypeScript + Tailwind.
- Backend: Node.js + TypeScript con Express o Fastify.
- Base de datos: PostgreSQL + Prisma.
- Deploy futuro: Docker + VPS + Nginx o Nginx Proxy Manager.
Nada de este stack esta implementado todavia en el repositorio. Su adopcion requiere especificaciones tecnicas aprobadas en sprints posteriores.
Estado: fase documental avanzada. Las specs funcionales del MVP candidate-first han sido creadas. El siguiente paso es iniciar el desarrollo tecnico.
El objetivo de esta fase ha sido crear una base clara de producto, alcance, metodologia, calidad, seguridad y trabajo con agentes IA antes de escribir codigo.
.
├── AGENTS.md
├── CLAUDE.md
├── README.md
└── docs
├── agents
│ ├── README.md
│ ├── concepts.md
│ ├── workflow.md
│ ├── sdd-tdd-ai-audit-workflow.md
│ ├── tdd-guidelines.md
│ ├── audit-quality-security-skill.md
│ ├── pr-checklist.md
│ ├── checklists
│ ├── claude
│ ├── codex
│ ├── prompts
│ ├── skills
│ └── templates
├── architecture
│ ├── 00-architecture-overview.md
│ ├── 01-repository-structure.md
│ └── 02-mvp-modules.md
├── decisions
│ ├── ADR-0001-start-from-scratch.md
│ ├── ADR-0002-initial-stack.md
│ ├── ADR-0003-sdd-and-agent-workflow.md
│ └── ADR-0004-sdd-tdd-ai-audit-workflow.md
├── product
│ └── 00-product-brief.md
├── specs
│ ├── 00-mvp-scope.md
│ ├── spec-template.md
│ └── features
│ ├── auth.md
│ ├── candidate-profile-cv.md
│ ├── jobs.md
│ ├── saved-jobs.md
│ ├── match-basic.md
│ └── dashboard.md
└── sprints
├── pre-sprint-00A-documentation.md
├── pre-sprint-00B-architecture.md
└── pre-sprint-00C-functional-specs.md
JobIT usa ramas cortas y revisables. No se trabaja directamente sobre main ni dev.
main: rama estable. Solo recibe cambios validados desdedev.dev: rama de integracion. Todas las PR deben apuntar aqui salvo decision explicita.docs/*: documentacion, decisiones, specs y guias.feat/*: nuevas funcionalidades con spec previa.fix/*: correcciones acotadas.chore/*: mantenimiento, ajustes internos o tareas no funcionales.
Reglas operativas:
- Crear cada rama desde
devactualizado. - Confirmar rama activa y
git status --shortantes de modificar. - Mantener cambios pequenos, revisables y reversibles.
- Separar cambios documentales de cambios de codigo cuando el alcance lo permita.
- Abrir PR hacia
devsolo tras verificaciones y auditoria.
Rama usada para formalizar este flujo:
docs/pre-sprint-00b-workflow-governance
JobIT sigue una metodologia SDD, Specification-Driven Development, combinada con TDD pragmatico, agentes IA controlados, auditoria documental/tecnica de calidad y seguridad, Pull Requests y Docs as Code.
Flujo base:
- Crear rama desde
dev. - Crear o actualizar una spec en
docs/specs/. - Definir tests minimos antes de implementar.
- Implementar con TDD pragmatico y asistencia controlada de IA.
- Ejecutar verificaciones locales.
- Pasar auditoria de calidad y seguridad.
- Corregir cualquier fallo detectado.
- Actualizar la documentacion dentro de la misma rama.
- Abrir PR hacia
dev.
Reglas de bloqueo:
- No se implementa una feature sin spec previa en
docs/specs/. - No se abre PR si la auditoria quality/security devuelve
FAIL. - No se abre PR si faltan verificaciones locales razonables para el alcance.
- La documentacion afectada debe actualizarse en la misma rama antes de la PR.
- La IA es copiloto, no piloto automatico: una persona revisa y valida el resultado.
Documentos de referencia:
- Flujo SDD + TDD + AI Audit.
- Guia de TDD pragmatico.
- Auditoria quality/security.
- Checklist de PR.
- Plantilla de spec.
- ADR-0004 metodologico.
Los agentes IA pueden ayudar a documentar, analizar, proponer, implementar tareas controladas y revisar cambios. Deben respetar siempre el alcance aprobado, trabajar con prompts pequenos, aplicar prompt chaining cuando el trabajo sea largo, mantener cambios reversibles y entregar un resumen final.
Las reglas operativas para agentes estan en AGENTS.md.
El siguiente paso recomendado es revisar las specs funcionales del MVP con el equipo de producto y tecnico, cerrar las decisiones de stack (ADRs pendientes) y abrir el primer sprint de implementacion.