Django Spike De-Spike Workflow
Use this skill when exploratory Django code has answered a question but is not yet fit to keep. Preserve the learning, throw away accidental design, and rebuild the feature with tests that express the real behavior.
Source Traceability
Primary source: Harry Percival, Test-Driven Development with Python, 3rd ed. Guidance is transformed and paraphrased from chapters 19 and 20, especially passwordless authentication, branch-based spikes, de-spiking, custom user/token models, email flow tests, and introducing mocks only at external boundaries.
Workflow
Label the spike.
- Identify what question it answered.
- Separate facts learned from code to keep.
- Save notes, screenshots, shell commands, or minimal examples if they matter.
Write behavior from the spike.
- Convert the useful behavior into a functional or integration test.
- Keep the test user-facing when the spike proved a workflow.
- Add lower-level tests for token models, forms, views, or email boundaries.
Revert or quarantine the spike.
- Revert the exploratory branch or isolate it from production code.
- Rebuild in small red/green/refactor steps.
- Keep commits narrow enough to review.
Introduce seams deliberately.
- Use fakes or mocks only for external email/service boundaries.
- Keep Django auth and model behavior real unless the test boundary says otherwise.
Read spike-despike-patterns.md for branch discipline, auth-flow slicing, and de-spiking checklists.
Decision Rules
- If the spike is mostly UI flow, start de-spiking from a functional test.
- If the spike proved a model or token rule, write model tests before rebuilding views.
- If the spike touched email, test the message boundary without hitting real email services.
- If the spike changed authentication models, keep migration and compatibility risks explicit.
- If the spike's code is messy but behavior is right, prefer rebuild over incremental cleanup.
Guardrails
- Do not merge spike code just because it works once.
- Do not preserve hardcoded secrets, magic tokens, or one-off settings from the spike.
- Do not mock away Django authentication behavior when auth integration is the point.
- Do not lose the learning when reverting the code.
Verification
Before finishing, report:
- Spike question and learning.
- Tests that capture intended behavior.
- What spike code was reverted, discarded, or rebuilt.
- External boundaries mocked or faked.
- Focused Django test command and result.
1---2name: django-spike-despike-workflow3description: "Manage Django spikes and de-spiking with tests: branch experiments, exploratory code, learning capture, functional tests against spiked behavior, revert-and-rebuild, custom auth flows, email/token models, and dependency seams. Use when a Django feature was prototyped quickly and needs to be turned into production-quality tested code."4license: MIT5compatibility: Codex, Claude Code, and other Agent Skills-compatible clients.6metadata:7 source: https://skillmd.com/skills/hashgraph-online/django-spike-despike-workflow8 version: "0.1.0"9 displayName: Django Spike De-Spike Workflow10 category: Django11 tags: django,tdd,spikes,auth,testing12---1314# Django Spike De-Spike Workflow1516Use this skill when exploratory Django code has answered a question but is not yet fit to keep. Preserve the learning, throw away accidental design, and rebuild the feature with tests that express the real behavior.1718## Source Traceability1920Primary source: Harry Percival, *Test-Driven Development with Python*, 3rd ed. Guidance is transformed and paraphrased from chapters 19 and 20, especially passwordless authentication, branch-based spikes, de-spiking, custom user/token models, email flow tests, and introducing mocks only at external boundaries.2122## Workflow23241. Label the spike.25 - Identify what question it answered.26 - Separate facts learned from code to keep.27 - Save notes, screenshots, shell commands, or minimal examples if they matter.28292. Write behavior from the spike.30 - Convert the useful behavior into a functional or integration test.31 - Keep the test user-facing when the spike proved a workflow.32 - Add lower-level tests for token models, forms, views, or email boundaries.33343. Revert or quarantine the spike.35 - Revert the exploratory branch or isolate it from production code.36 - Rebuild in small red/green/refactor steps.37 - Keep commits narrow enough to review.38394. Introduce seams deliberately.40 - Use fakes or mocks only for external email/service boundaries.41 - Keep Django auth and model behavior real unless the test boundary says otherwise.4243Read [spike-despike-patterns.md](references/spike-despike-patterns.md) for branch discipline, auth-flow slicing, and de-spiking checklists.4445## Decision Rules4647- If the spike is mostly UI flow, start de-spiking from a functional test.48- If the spike proved a model or token rule, write model tests before rebuilding views.49- If the spike touched email, test the message boundary without hitting real email services.50- If the spike changed authentication models, keep migration and compatibility risks explicit.51- If the spike's code is messy but behavior is right, prefer rebuild over incremental cleanup.5253## Guardrails5455- Do not merge spike code just because it works once.56- Do not preserve hardcoded secrets, magic tokens, or one-off settings from the spike.57- Do not mock away Django authentication behavior when auth integration is the point.58- Do not lose the learning when reverting the code.5960## Verification6162Before finishing, report:6364- Spike question and learning.65- Tests that capture intended behavior.66- What spike code was reverted, discarded, or rebuilt.67- External boundaries mocked or faked.68- Focused Django test command and result.